Crear un conjunto de anuncios

POST /api/marketing/adsets

Crea el conjunto en Meta y devuelve el objeto releído. Sin status nace PAUSED. daily_budget y lifetime_budget son excluyentes (400 si vienen los dos) y un lifetime_budget exige end_time (400 si falta). Los montos van en centavos de la moneda de la cuenta. targeting viaja como objeto y Neike lo serializa a JSON. La combinación válida de billing_event, optimization_goal y el objetivo de la campaña la valida Meta del lado del servidor y no está publicada completa: Neike valida solo que cada valor pertenezca a su enum y devuelve el error de Meta mapeado. Requiere scope marketing:manage.

Request body

Field	Type		Description
`ad_account_id`	string	required	Cuenta publicitaria de Meta, con prefijo. Example: `"act_123"`.
`campaign_id`	string	required	Campaña a la que cuelga el conjunto.
`name`	string	required	Example: `"AR 25-45 · feed"`.
`status`	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`	optional	Si no viene, el conjunto se crea `PAUSED`. Default: `"PAUSED"`.
`daily_budget`	number	optional	Presupuesto diario en centavos. Excluyente con `lifetime_budget`. Example: `50000`.
`lifetime_budget`	number	optional	Presupuesto total en centavos. Excluyente con `daily_budget` y exige `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	Puja en centavos.
`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	Segmentación. Viaja como objeto y Neike la serializa a JSON antes de mandarla a Graph. Example: `{"geo_locations":{"countries":["AR"]},"age_min":25,"age_max":45,"publisher_platforms":["facebook","instagram"]}`.
`promoted_object`	object	optional	`{page_id}`, `{application_id, object_store_url}` o `{pixel_id}`.
`dsa_payor`	string	optional	Pagador declarado (DSA europea).
`dsa_beneficiary`	string	optional	Beneficiario declarado (DSA europea).

Responses

Status	Description	Schema
`201`	—	AdSetDto

Example

curl -X POST https://api.neike.dev/api/marketing/adsets \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "ad_account_id": "act_123",
       "campaign_id": "string",
       "name": "AR 25-45 · feed"
     }'

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	Estado calculado por Meta, de solo lectura.
`daily_budget`	string	optional	Presupuesto diario en centavos. Example: `"50000"`.
`lifetime_budget`	string	optional	Presupuesto total en centavos.
`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	Puja en centavos.
`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	Segmentación tal como la guarda Meta.
`promoted_object`	object	optional	Objeto promocionado (página, app o píxel).
`created_time`	string	optional	—
`updated_time`	string	optional	—