PATCH /ads/ads/{id}
Update or pause a ad: name, status (PAUSED, ACTIVE, ARCHIVED, DELETED). Pausing needs no confirm; ACTIVE and spend changes need confirm: true
PATCH
BearerAuthheader
AuthorizationBearer <token>API key sk_...
id*stringad id
application/json- body
accountId*stringname?stringstatus?stringValue in
"ACTIVE""PAUSED""ARCHIVED""DELETED"dailyBudget?integerDaily budget, in the ad account currency's minor units (cents)
Range
100 <= valuelifetimeBudget?integerLifetime budget, in the ad account currency's minor units (cents)
Range
100 <= valuespendCap?integerCampaign spend cap, in the ad account currency's minor units (cents)
Range
100 <= valuebidAmount?integerAd set bid cap, in the ad account currency's minor units (cents)
Range
100 <= valueendTime?stringAd set end
Format
date-timestopTime?stringCampaign end
Format
date-timetargeting?Simplified targeting, mapped to Meta's targeting spec
confirm?booleanRequired (true) for anything that can spend: creates (campaign, ad set, ad, boost), status ACTIVE, budget, bid, schedule or targeting changes. Without it: 400 confirmation_required, nothing is created
{item, mock}
application/json- response
item?mock?booleancurl -X PATCH 'https://example.com/api/v1/ads/ads/string' \ -H 'Content-Type: application/json' \ -d '{ "accountId": "string"}'Example Response
{ "item": {}, "mock": true}