Edit an ad set

PATCH /api/marketing/adsets/{adSetId}

Only the fields present are sent to Meta. The two budget rules still apply: they are mutually exclusive, and lifetime_budget must come with end_time. Requires the marketing:manage scope.

Request body

Field	Type		Description
`ad_account_id`	string	required	Ad account that owns the ad set. Example: `"act_123"`.
`name`	string	optional	—
`status`	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`	optional	—
`daily_budget`	number	optional	Daily budget in cents.
`lifetime_budget`	number	optional	Lifetime budget in cents. Requires `end_time`.
`billing_event`	`APP_INSTALLS` · `CLICKS` · `IMPRESSIONS` · `LINK_CLICKS` · `NONE` · `OFFER_CLAIMS` · `PAGE_LIKES` · `POST_ENGAGEMENT` · `THRUPLAY` · `PURCHASE` · `LISTING_INTERACTION`	optional	—
`optimization_goal`	`NONE` · `APP_INSTALLS` · `AD_RECALL_LIFT` · `ENGAGED_USERS` · `EVENT_RESPONSES` · `IMPRESSIONS` · `LEAD_GENERATION` · `QUALITY_LEAD` · `LINK_CLICKS` · `OFFSITE_CONVERSIONS` · `PAGE_LIKES` · `POST_ENGAGEMENT` · `QUALITY_CALL` · `REACH` · `LANDING_PAGE_VIEWS` · `VISIT_INSTAGRAM_PROFILE` · `ENGAGED_PAGE_VIEWS` · `VALUE` · `THRUPLAY` · `DERIVED_EVENTS` · `APP_INSTALLS_AND_OFFSITE_CONVERSIONS` · `CONVERSATIONS` · `IN_APP_VALUE` · `MESSAGING_PURCHASE_CONVERSION` · `MESSAGING_DEEP_CONVERSATION_AND_FOLLOW` · `SUBSCRIBERS` · `REMINDERS_SET` · `MEANINGFUL_CALL_ATTEMPT` · `PROFILE_VISIT` · `PROFILE_AND_PAGE_ENGAGEMENT` · `ADVERTISER_SILOED_VALUE` · `AUTOMATIC_OBJECTIVE` · `MESSAGING_APPOINTMENT_CONVERSION`	optional	—
`bid_amount`	number	optional	Bid in cents.
`bid_strategy`	`LOWEST_COST_WITHOUT_CAP` · `LOWEST_COST_WITH_BID_CAP` · `COST_CAP` · `LOWEST_COST_WITH_MIN_ROAS`	optional	—
`start_time`	string	optional	—
`end_time`	string	optional	—
`targeting`	object	optional	—
`promoted_object`	object	optional	—
`dsa_payor`	string	optional	—
`dsa_beneficiary`	string	optional	—

Responses

Status	Description	Schema
`200`	—	AdSetDto

Example

curl -X PATCH https://api.neike.dev/api/marketing/adsets/{adSetId} \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "ad_account_id": "act_123"
     }'

AdSetDto

Field	Type		Description
`id`	string	required	Example: `"120210000000000000"`.
`name`	string	required	Example: `"AR 25-45 · feed"`.
`campaign_id`	string	optional	Example: `"120210000000000000"`.
`status`	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`	optional	—
`effective_status`	string	optional	Status computed by Meta, read-only.
`daily_budget`	string	optional	Daily budget in cents. Example: `"50000"`.
`lifetime_budget`	string	optional	Lifetime budget in cents.
`billing_event`	`APP_INSTALLS` · `CLICKS` · `IMPRESSIONS` · `LINK_CLICKS` · `NONE` · `OFFER_CLAIMS` · `PAGE_LIKES` · `POST_ENGAGEMENT` · `THRUPLAY` · `PURCHASE` · `LISTING_INTERACTION`	optional	—
`optimization_goal`	`NONE` · `APP_INSTALLS` · `AD_RECALL_LIFT` · `ENGAGED_USERS` · `EVENT_RESPONSES` · `IMPRESSIONS` · `LEAD_GENERATION` · `QUALITY_LEAD` · `LINK_CLICKS` · `OFFSITE_CONVERSIONS` · `PAGE_LIKES` · `POST_ENGAGEMENT` · `QUALITY_CALL` · `REACH` · `LANDING_PAGE_VIEWS` · `VISIT_INSTAGRAM_PROFILE` · `ENGAGED_PAGE_VIEWS` · `VALUE` · `THRUPLAY` · `DERIVED_EVENTS` · `APP_INSTALLS_AND_OFFSITE_CONVERSIONS` · `CONVERSATIONS` · `IN_APP_VALUE` · `MESSAGING_PURCHASE_CONVERSION` · `MESSAGING_DEEP_CONVERSATION_AND_FOLLOW` · `SUBSCRIBERS` · `REMINDERS_SET` · `MEANINGFUL_CALL_ATTEMPT` · `PROFILE_VISIT` · `PROFILE_AND_PAGE_ENGAGEMENT` · `ADVERTISER_SILOED_VALUE` · `AUTOMATIC_OBJECTIVE` · `MESSAGING_APPOINTMENT_CONVERSION`	optional	—
`bid_amount`	string	optional	Bid in cents.
`bid_strategy`	`LOWEST_COST_WITHOUT_CAP` · `LOWEST_COST_WITH_BID_CAP` · `COST_CAP` · `LOWEST_COST_WITH_MIN_ROAS`	optional	—
`start_time`	string	optional	Example: `"2026-09-01T00:00:00-0300"`.
`end_time`	string	optional	Example: `"2026-09-30T23:59:59-0300"`.
`targeting`	object	optional	Targeting as stored by Meta.
`promoted_object`	object	optional	Promoted object (page, app or pixel).
`created_time`	string	optional	—
`updated_time`	string	optional	—