Edit a campaign

PATCH /api/marketing/campaigns/{campaignId}

Only the fields present are sent to Meta; a null does not clear the previous value. daily_budget and lifetime_budget are still mutually exclusive. Requires the marketing:manage scope.

Authentication

Send your API key in the x-neike-api-key header. Console sessions can use a bearer JWT plus x-neike-client-id instead.

Request body

Field	Type		Description
ad_account_id	string	required	Ad account that owns the campaign. Example: "act_123".
name	string	optional	—
status	ACTIVE · PAUSED · DELETED · ARCHIVED	optional	—
special_ad_categories	NONE · EMPLOYMENT · HOUSING · CREDIT · ISSUES_ELECTIONS_POLITICS · ONLINE_GAMBLING_AND_GAMING · FINANCIAL_PRODUCTS_SERVICES[]	optional	—
daily_budget	number	optional	Daily budget in cents.
lifetime_budget	number	optional	Lifetime budget in cents.
bid_strategy	LOWEST_COST_WITHOUT_CAP · LOWEST_COST_WITH_BID_CAP · COST_CAP · LOWEST_COST_WITH_MIN_ROAS	optional	—
spend_cap	number	optional	Spend cap of the campaign, in cents.
start_time	string	optional	—
stop_time	string	optional	—

Responses

Status	Description	Schema
200	—	CampaignDto

Example

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

CampaignDto

Field	Type		Description
id	string	required	Example: "120210000000000000".
name	string	required	Example: "Tráfico · septiembre".
objective	APP_INSTALLS · BRAND_AWARENESS · CONVERSIONS · EVENT_RESPONSES · LEAD_GENERATION · LINK_CLICKS · LOCAL_AWARENESS · MESSAGES · OFFER_CLAIMS · OUTCOME_APP_PROMOTION · OUTCOME_AWARENESS · OUTCOME_ENGAGEMENT · OUTCOME_LEADS · OUTCOME_SALES · OUTCOME_TRAFFIC · PAGE_LIKES · POST_ENGAGEMENT · PRODUCT_CATALOG_SALES · REACH · STORE_VISITS · VIDEO_VIEWS	optional	—
status	ACTIVE · PAUSED · DELETED · ARCHIVED	optional	—
effective_status	string	optional	Effective status computed by Meta (includes review statuses and those inherited from the account). It is read-only and has more values than status. Example: "PAUSED".
special_ad_categories	NONE · EMPLOYMENT · HOUSING · CREDIT · ISSUES_ELECTIONS_POLITICS · ONLINE_GAMBLING_AND_GAMING · FINANCIAL_PRODUCTS_SERVICES[]	optional	—
buying_type	AUCTION · RESERVED	optional	—
daily_budget	string	optional	Daily budget in cents. Example: "100000".
lifetime_budget	string	optional	Lifetime budget in cents. Example: "500000".
spend_cap	string	optional	Spend cap in cents. Example: "1000000".
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".
stop_time	string	optional	Example: "2026-09-30T23:59:59-0300".
created_time	string	optional	—
updated_time	string	optional	—