Sign in
ads
campaign

Update a campaign

patch/ads/{connection_id}/campaign/{id}

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Campaign

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Request body

idstring
created_atstring date-time
updated_atstring date-time
namestring
organization_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
effective_status'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
start_atstring date-time
end_atstring date-time
budget_amountnumber
budget_period'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
budget_unit'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
total_spend_amountnumber
goal'UNSPECIFIED' | 'BRAND_AWARENESS' | 'ENGAGEMENT' | 'REACH' | 'WEBSITE_TRAFFIC' | 'LEADS' | 'SALES' | 'APP_PROMOTION'
planned_spend_amountnumber
advertising_channel_type'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
campaign_budget_identifierstring
currencystring
categorystring
has_eu_political_adsboolean
labelsstring[]
rawobject

Response

Successful

idstring
created_atstring date-time
updated_atstring date-time
namestring
organization_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
effective_status'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
start_atstring date-time
end_atstring date-time
budget_amountnumber
budget_period'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
budget_unit'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
total_spend_amountnumber
goal'UNSPECIFIED' | 'BRAND_AWARENESS' | 'ENGAGEMENT' | 'REACH' | 'WEBSITE_TRAFFIC' | 'LEADS' | 'SALES' | 'APP_PROMOTION'
planned_spend_amountnumber
advertising_channel_type'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
campaign_budget_identifierstring
currencystring
categorystring
has_eu_political_adsboolean
labelsstring[]
rawobject

Changes

Changed in 4 of the 25 revisions of this API.416

  • 1fbb53b883653See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the enum value kpi to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 1f72720916e43See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the enum value labels to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 963bcc74f9e336See the full diff
    • ●

      added the new CTV enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new DOOH enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new NATIVE enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the enum value budget_unit to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the new CTV enum value to the request property

      request-property-enum-value-added

    • ○

      added the new DOOH enum value to the request property

      request-property-enum-value-added

    • ○

      added the new NATIVE enum value to the request property

      request-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 8f243766856714See the full diff
    • ●

      added the new ENGAGEMENT enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the enum value effective_status to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the new ENGAGEMENT enum value to the request property

      request-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added