> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkedcamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update campaign settings

> **Write.** It changes data in your account.

Change a campaign's SETTINGS: title, sending accounts, schedule, daily limits, timezone and every safety toggle. Only the fields you pass are changed. Attaching accounts is done here: one `linkedAccountId` for LinkedIn steps, and `emailAccountIds` — a list — for EMAIL steps. Ask the user which accounts when there is a choice. NOT this endpoint: campaign status. It cannot start, pause, resume, archive or delete a campaign, and there is no `status` parameter. To start one use `campaign_launch`; to pause or resume one, `campaign_set_status`; to remove one, `campaign_delete`. Archiving is web-app only and has no endpoint at all — say so rather than looking for a substitute. Nor does it touch the sequence (`flow_set`) or the audience (`campaign_set_source`). One side effect worth knowing: changing `linkedAccountId` rewrites that account onto every lead already in the campaign, not just future ones.



## OpenAPI

````yaml /api-v2/openapi.json post /campaign_update
openapi: 3.1.0
info:
  title: LinkedCamp API
  version: 2.0.0
  description: >-
    Version 2 of the LinkedCamp API. Every endpoint is a POST to `/{endpoint}`
    with its arguments as a JSON object, and returns JSON.
servers:
  - url: https://api.linkedcamp.com/v2
security:
  - ApiKey: []
  - Bearer: []
tags:
  - name: Account
  - name: Notifications
  - name: Reference
  - name: Campaigns
  - name: Campaign audience
  - name: Sequences
  - name: Blocked dates
  - name: Leads
  - name: Lead notes
  - name: Activities
  - name: Tags
  - name: Blacklist
  - name: Conversations
  - name: Messages
  - name: Saved replies
  - name: Templates
  - name: Merge fields
  - name: Personalised images
  - name: LinkedIn accounts
  - name: Email accounts
  - name: AI agents
  - name: Knowledge base
  - name: Personas
  - name: Analytics
  - name: Posts
  - name: Posting schedule
  - name: Tasks
  - name: Appointments
  - name: Reminders
  - name: Automations
paths:
  /campaign_update:
    post:
      tags:
        - Campaigns
      summary: Update campaign settings
      description: >-
        **Write.** It changes data in your account.


        Change a campaign's SETTINGS: title, sending accounts, schedule, daily
        limits, timezone and every safety toggle. Only the fields you pass are
        changed. Attaching accounts is done here: one `linkedAccountId` for
        LinkedIn steps, and `emailAccountIds` — a list — for EMAIL steps. Ask
        the user which accounts when there is a choice. NOT this endpoint:
        campaign status. It cannot start, pause, resume, archive or delete a
        campaign, and there is no `status` parameter. To start one use
        `campaign_launch`; to pause or resume one, `campaign_set_status`; to
        remove one, `campaign_delete`. Archiving is web-app only and has no
        endpoint at all — say so rather than looking for a substitute. Nor does
        it touch the sequence (`flow_set`) or the audience
        (`campaign_set_source`). One side effect worth knowing: changing
        `linkedAccountId` rewrites that account onto every lead already in the
        campaign, not just future ones.
      operationId: campaign_update
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                campaignId:
                  type: string
                  description: Campaign id, from `campaign_list` or `campaign_create`.
                title:
                  type: string
                  description: Short label.
                linkedAccountId:
                  type: string
                  description: >-
                    The ONE LinkedIn account this campaign sends from. Required
                    for any LinkedIn step. A campaign cannot use two. If
                    `linkedin_account_list` returns more than one, ask the user
                    which — do not pick for them.
                emailAccountIds:
                  type: array
                  items:
                    type: string
                  description: >-
                    Mailboxes for EMAIL steps. Unlike the LinkedIn account,
                    several are allowed and sends rotate across them. Only
                    attach these if the user wants email steps, and ask which
                    mailboxes.
                timezone:
                  type: string
                  description: >-
                    IANA timezone, e.g. "America/New_York". Governs the
                    schedule.
                schedule:
                  type: object
                  properties:
                    '0':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Sunday
                    '1':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Monday
                    '2':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Tuesday
                    '3':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Wednesday
                    '4':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Thursday
                    '5':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Friday
                    '6':
                      type: object
                      properties:
                        startTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "9:00".
                        endTime:
                          type: string
                          description: 24-hour "H:MM", e.g. "18:00".
                        enabled:
                          type: boolean
                          description: >-
                            Whether this weekday sends at all. False blocks the
                            whole day regardless of the times below.
                      required:
                        - startTime
                        - endTime
                        - enabled
                      additionalProperties: false
                      description: Saturday
                  additionalProperties: false
                  description: >-
                    Sending window per weekday, keyed 0 (Sunday) to 6
                    (Saturday), in the campaign timezone.
                campaginLimits:
                  type: object
                  properties:
                    CONNECT:
                      type: integer
                      minimum: 0
                      description: Connection invites per day.
                    MESSAGE:
                      type: integer
                      minimum: 0
                      description: LinkedIn messages per day.
                    INMAILS:
                      type: integer
                      minimum: 0
                      description: InMails per day.
                    ENGAGEMENT:
                      type: integer
                      minimum: 0
                      description: Profile engagements per day.
                    FOLLOW:
                      type: integer
                      minimum: 0
                      description: Follows per day.
                  additionalProperties: false
                  description: Per-day caps per step type. Note the field spelling.
                tags:
                  type: array
                  items:
                    type: string
                  description: >-
                    Tag ids applied to every lead in this campaign — this
                    identifies the campaign's leads, so it should be a tag
                    belonging to THIS campaign. Never reuse another campaign's
                    tag: the two campaigns' leads then become indistinguishable.
                    Mint one with `tag_create` (short label, interest NEUTRAL)
                    and pass its id. Pass [] to remove all tags.
                assignTo:
                  type: object
                  additionalProperties: false
                  description: Assign leads to team members. Shape mirrors the web app.
                leadsPriority:
                  type: string
                  description: >-
                    Ordering strategy for working the lead queue, e.g. "newest"
                    / "oldest".
                stopOnReply:
                  type: boolean
                  description: Halt a lead's sequence as soon as they reply. Default true.
                skipProfiles:
                  type: boolean
                  description: Skip prospects you already have an open conversation with.
                uniqueProfiles:
                  type: boolean
                  description: Never enrol the same profile in two campaigns. Default true.
                premiumProfiles:
                  type: boolean
                  description: Only target LinkedIn Premium / Open Profile members.
                connectionOutreach:
                  type: boolean
                  description: Target existing 1st-degree connections instead of new ones.
                snOutreach:
                  type: boolean
                  description: >-
                    Use Sales Navigator messaging. Requires a Premium LinkedIn
                    account.
                prioritizeNewLeads:
                  type: boolean
                  description: Work newly-found prospects before older ones.
                reload:
                  type: boolean
                  description: >-
                    Re-run the search periodically to pull in newly matching
                    prospects.
                trackOpens:
                  type: boolean
                  description: 'EMAIL steps: insert an open-tracking pixel.'
                trackClicks:
                  type: boolean
                  description: 'EMAIL steps: rewrite links for click tracking.'
                emailAsText:
                  type: boolean
                  description: >-
                    Send email as plain text. Better deliverability, no
                    tracking.
                pauseCampaign:
                  type: boolean
                  description: Pause the campaign without changing its status.
                scheduledAt:
                  type:
                    - string
                    - number
                  description: >-
                    Future timestamp to auto-start the campaign, instead of
                    launching it now with `campaign_launch`.
                agentId:
                  type:
                    - string
                    - 'null'
                  description: >-
                    AI agent that answers replies in this campaign's inbox. Pass
                    null to detach it. Never set this on your own: an agent
                    writes to real prospects without further approval. Ask the
                    user whether they want one, and offer both routes — pick an
                    existing agent from `agent_list`, or build one with
                    `agent_upsert`, give it material with `kb_upsert` and
                    `kb_attach`, then `agent_train`. A campaign with no agent is
                    perfectly normal; replies just come to the inbox.
              required:
                - campaignId
              additionalProperties: false
      responses:
        '200':
          description: >-
            The result, as JSON. Writes answer `{ "ok": true, "message": ...,
            "data": ... }`.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: >-
            The body is not valid JSON, an argument is invalid, or the request
            was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No API key, or the key was rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Your plan, permissions or access tier don't include this, or a
            record belongs to another account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: A record named in the arguments does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            The request was valid but the operation was refused, such as
            launching a campaign that is not ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: The service failed or could not be reached. Reads are safe to retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: >-
            The operation timed out. A write may still complete; read it back
            before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - UNAUTHENTICATED
                - FORBIDDEN
                - PLAN_REQUIRED
                - VALIDATION
                - INVALID_JSON
                - NOT_FOUND
                - METHOD_NOT_ALLOWED
                - UPSTREAM
                - TOOL_ERROR
            message:
              type: string
            hint:
              type: string
              description: What to do about it, when there is something to do.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Your LinkedCamp API key.
    Bearer:
      type: http
      scheme: bearer
      description: Your LinkedCamp API key as a bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.