PATCH /ads/adsets/{id}

Update or pause a ad set: name, status (PAUSED, ACTIVE, ARCHIVED, DELETED), dailyBudget, lifetimeBudget, bidAmount, endTime, targeting. Pausing needs no confirm; ACTIVE and spend changes need confirm: true

PATCH
/ads/adsets/{id}

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

ad set id

Request Body

application/json
  1. body
accountId*string
name?string
status?string
Value in"ACTIVE""PAUSED""ARCHIVED""DELETED"
dailyBudget?integer

Daily budget, in the ad account currency's minor units (cents)

Range100 <= value
lifetimeBudget?integer

Lifetime budget, in the ad account currency's minor units (cents)

Range100 <= value
spendCap?integer

Campaign spend cap, in the ad account currency's minor units (cents)

Range100 <= value
bidAmount?integer

Ad set bid cap, in the ad account currency's minor units (cents)

Range100 <= value
endTime?string

Ad set end

Formatdate-time
stopTime?string

Campaign end

Formatdate-time
targeting?

Simplified targeting, mapped to Meta's targeting spec

confirm?boolean

Required (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

Response Body

{item, mock}

application/json
  1. response
item?
mock?boolean
Example Request
curl -X PATCH 'https://example.com/api/v1/ads/adsets/string' \  -H 'Content-Type: application/json' \  -d '{  "accountId": "string"}'
Example Response
{  "item": {},  "mock": true}