Create a creative

POST /api/marketing/creatives

The object_story_spec carries the page that publishes and exactly one of link_data or video_data: sending both, or neither, is 400. The image is referenced by the hash from POST /api/marketing/images and the video by the id from POST /api/marketing/videos. 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	Meta ad account, with prefix. Example: "act_123".
name	string	optional	Example: "Creatividad tráfico".
object_story_spec	ObjectStorySpecDto	required	—
degrees_of_freedom_spec	object	optional	Configuration of Meta’s automatic variations. It is passed through as is.

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	—