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

# Update Linkedin Campaign

> Update an existing campaign's settings (name, status, budget, bid, schedule, delivery options, targeting). Only provided fields are updated via RestLi PARTIAL_UPDATE. objective_type and format are absent on purpose: LinkedIn freezes both once the campaign is saved. Pass expected_version_tag to have the update refused if the campaign changed since you read it. VOCABULARY: the API's `campaign` is what Campaign Manager shows as "Ad set" (campaignGroup="Campaign", campaign="Ad set", creative="Ad"). Say both names when reporting to a user, or they will look in the wrong tab and think nothing happened.



## OpenAPI

````yaml /api-reference/openapi.yaml post /linkedin/mcp#update_linkedin_campaign
openapi: 3.1.0
info:
  title: Multi-Source Ads API
  version: 1.0.0
  description: >-
    Unified API for managing ad campaigns across Meta, LinkedIn, and Google. MCP
    tools are accessed via JSON-RPC 2.0 over HTTP (`POST /{source}/mcp`). Google
    Sheets/Drive endpoints use standard REST.
servers:
  - url: https://api.adside.ai
    description: Production
  - url: http://localhost:3100
    description: Local development
security:
  - bearerAuth: []
tags:
  - name: Accounts
    description: ''
  - name: Ads
    description: ''
  - name: Analytics
    description: ''
  - name: Asset Groups
    description: ''
  - name: Assets
    description: ''
  - name: Audiences
    description: ''
  - name: Campaign Groups
    description: ''
  - name: Campaigns
    description: ''
  - name: Conversions
    description: ''
  - name: Creatives
    description: ''
  - name: Drive
    description: ''
  - name: Google
    description: ''
  - name: Google Ads
    description: ''
  - name: Google Tag Manager
    description: ''
  - name: Keywords
    description: ''
  - name: Linkedin
    description: ''
  - name: Meta
    description: ''
  - name: Meta Reporting
    description: ''
  - name: OAuth
    description: ''
  - name: Other
    description: ''
  - name: Reports
    description: ''
  - name: Sheets
    description: ''
  - name: Targeting
    description: ''
  - name: Tiktok
    description: ''
  - name: Workspace
    description: ''
paths:
  /linkedin/mcp#update_linkedin_campaign:
    post:
      tags:
        - Linkedin
        - Campaigns
      summary: Update Linkedin Campaign
      description: >-
        Update an existing campaign's settings (name, status, budget, bid,
        schedule, delivery options, targeting). Only provided fields are updated
        via RestLi PARTIAL_UPDATE. objective_type and format are absent on
        purpose: LinkedIn freezes both once the campaign is saved. Pass
        expected_version_tag to have the update refused if the campaign changed
        since you read it. VOCABULARY: the API's `campaign` is what Campaign
        Manager shows as "Ad set" (campaignGroup="Campaign", campaign="Ad set",
        creative="Ad"). Say both names when reporting to a user, or they will
        look in the wrong tab and think nothing happened.
      operationId: linkedin_update_linkedin_campaign
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  const: '2.0'
                id:
                  type: string
                  example: '1'
                method:
                  type: string
                  const: tools/call
                params:
                  type: object
                  required:
                    - name
                    - arguments
                  properties:
                    name:
                      type: string
                      const: update_linkedin_campaign
                    arguments:
                      $ref: >-
                        #/components/schemas/linkedin_update_linkedin_campaign_input
      responses:
        '200':
          description: JSON-RPC response with tool result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpToolResponse'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Channel not connected or access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    linkedin_update_linkedin_campaign_input:
      type: object
      properties:
        account_id:
          description: >-
            LinkedIn Ad Account ID. Omit it: it defaults to the account this
            client is connected to, and any other account is refused.
          type: string
        campaign_id:
          type: string
          description: ID of the campaign to update
        expected_version_tag:
          description: >-
            Version tag you read from the campaign (version.versionTag). If
            provided, the update is refused when the campaign has changed since
            — use it whenever you read, decided, then wrote, so you do not
            silently overwrite someone else's edit. targeting_criteria is the
            case it exists for: it replaces the audience wholesale, so writing
            one built from a stale read discards whatever the other editor
            targeted.
          type: string
        name:
          description: New campaign name
          type: string
        status:
          description: New status
          type: string
          enum:
            - ACTIVE
            - PAUSED
            - ARCHIVED
            - DRAFT
        daily_budget_amount:
          description: New daily budget amount
          type: string
        daily_budget_currency:
          description: ISO currency code for daily budget
          type: string
        total_budget_amount:
          description: New total budget amount
          type: string
        total_budget_currency:
          description: ISO currency code for total budget
          type: string
        unit_cost_amount:
          description: New bid amount
          type: string
        unit_cost_currency:
          description: ISO currency code for bid
          type: string
        optimization_target_type:
          description: >-
            New optimization target. Changing it changes the bidding mode — see
            create_campaign for the mode each value activates and the cost_type
            it requires.
          type: string
          enum:
            - NONE
            - ENHANCED_CONVERSION
            - MAX_IMPRESSION
            - MAX_CLICK
            - MAX_CONVERSION
            - MAX_VIDEO_VIEW
            - MAX_LEAD
            - MAX_QUALIFIED_LEAD
            - MAX_REACH
            - TARGET_COST_PER_CLICK
            - TARGET_COST_PER_IMPRESSION
            - TARGET_COST_PER_VIDEO_VIEW
            - CAP_COST_AND_MAXIMIZE_CLICKS
            - CAP_COST_AND_MAXIMIZE_IMPRESSIONS
            - CAP_COST_AND_MAXIMIZE_VIDEO_VIEWS
            - CAP_COST_AND_MAXIMIZE_LEADS
        run_schedule_start:
          description: New start date
          type: number
        run_schedule_end:
          description: New end date
          type: number
        offsite_delivery_enabled:
          description: Enable/disable LinkedIn Audience Network
          type: boolean
        audience_expansion_enabled:
          description: Enable/disable audience expansion
          type: boolean
        targeting_criteria:
          description: >-
            Replace who the campaign targets. Send the COMPLETE expression, not
            just the part you are changing: this REPLACES the campaign's
            targeting wholesale (measured — an update carrying only seniorities
            dropped the campaign's locations). Read the campaign first
            (list_linkedin_campaigns returns targetingCriteria in the same shape
            this field takes), merge your change into it, then send the whole
            thing back. Keys are FACET URNs:
            {"include":{"and":[{"or":{"urn:li:adTargetingFacet:locations":["urn:li:geo:105015875"]}}]}}.
            Get URNs from search_targeting_facets, and segment URNs from
            list_ad_segments. Pair this with expected_version_tag — an audience
            you decided on after reading is exactly the write that must not
            silently overwrite someone else's edit.
          type: object
          properties:
            include:
              type: object
              properties:
                and:
                  type: array
                  items:
                    type: object
                    properties:
                      or:
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties:
                          type: array
                          items:
                            type: string
                    required:
                      - or
              required:
                - and
            exclude:
              type: object
              properties:
                or:
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties:
                    type: array
                    items:
                      type: string
              required:
                - or
          required:
            - include
      required:
        - campaign_id
      $schema: http://json-schema.org/draft-07/schema#
    McpToolResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        id:
          type: string
        result:
          type: object
          properties:
            content:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    const: text
                  text:
                    type: string
                    description: JSON-stringified tool result
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
        code:
          type: string
          enum:
            - UNAUTHORIZED
            - FORBIDDEN
            - NOT_FOUND
            - RATE_LIMITED
            - INTERNAL_ERROR
          description: Error code
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key (sk_live_*) — SHA256 hashed, looked up in Redis. Generate via
        the web app's workspace settings.

````