Update ad

Patch one or more fields on an ad. Status, budget, targeting, and creative changes are propagated to the platform.

Per-platform support:

• Meta (Facebook + Instagram): all fields supported.
• TikTok: status, budget, targeting (via /v2/adgroup/update/), and creative (via /v2/ad/update/ patch-style — headline is ignored, body becomes ad_text).
• Pinterest / X / LinkedIn / Google: status + budget only. Sending targeting or creative returns 501 with code unsupported_platform_operation.

PUT /v1/ads/{adId}

Patch one or more fields on an ad. Status, budget, targeting, and creative changes are propagated to the platform.

Per-platform support:

• Meta (Facebook + Instagram): all fields supported.
• TikTok: status, budget, targeting (via /v2/adgroup/update/), and creative (via /v2/ad/update/ patch-style — headline is ignored, body becomes ad_text).
• Pinterest / X / LinkedIn / Google: status + budget only. Sending targeting or creative returns 501 with code unsupported_platform_operation.

Parameters

• adId (path, string) required

Request body

Content-Type: application/json

• status (string) (enum: active, paused)
• budget (object)
• targeting (object) — Meta + TikTok only. Pinterest / X / LinkedIn / Google return 501.
• creative (object) — Replace the ad's creative. Meta + TikTok only. - Meta: requires headline, body, callToAction, linkUrl, imageUrl. The ad's existing creative is replaced via a new /act_X/adcreatives...
• name (string)

Responses

200 — Ad updated

• ad ($ref)
• message (string)

400 — Invalid status transition or budget below minimum

401

404

501 — targeting or creative not supported on the platform (Meta + TikTok only)