Crear una creatividad

POST /api/marketing/creatives

El object_story_spec lleva la página que publica y exactamente uno de link_data o video_data: mandar los dos, o ninguno, es 400. La imagen se referencia por el hash de POST /api/marketing/images y el video por el id de POST /api/marketing/videos. Requiere scope marketing:manage.

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	Cuenta publicitaria de Meta, con prefijo. Example: "act_123".
name	string	optional	Example: "Creatividad tráfico".
object_story_spec	ObjectStorySpecDto	required	—
degrees_of_freedom_spec	object	optional	Configuración de variaciones automáticas de Meta. Se pasa tal cual.

Responses

Status	Description	Schema
201	—	CreativeDto

Example

curl -X POST https://api.neike.dev/api/marketing/creatives \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "ad_account_id": "act_123",
       "object_story_spec": {
         "page_id": "string"
       }
     }'

CreativeDto

Field	Type		Description
id	string	required	Example: "120210000000000000".
name	string	optional	Example: "Creatividad tráfico".
status	string	optional	—
object_story_spec	ObjectStorySpecDto	optional	—
object_story_id	string	optional	—
effective_object_story_id	string	optional	—
thumbnail_url	string	optional	—
image_hash	string	optional	—
image_url	string	optional	—
video_id	string	optional	—
call_to_action_type	LEARN_MORE · SHOP_NOW · SIGN_UP · BOOK_TRAVEL · DOWNLOAD · GET_QUOTE · CONTACT_US · SUBSCRIBE · APPLY_NOW · GET_OFFER · MESSAGE_PAGE · WHATSAPP_MESSAGE · CALL_NOW · DONATE_NOW · SEE_MENU · ORDER_NOW · PLAY_GAME · INSTALL_MOBILE_APP · NO_BUTTON	optional	—