--- title: "Creates a creative based on the input ,it requires using images that have already been uploaded to NAM." method: POST path: "/api/v3/advertisers/{advertiserId}/creatives" tags: ["Creative"] --- # Creates a creative based on the input ,it requires using images that have already been uploaded to NAM. `POST /api/v3/advertisers/{advertiserId}/creatives` ## Request - Base URL: `https://ads.nextdoor.com` - URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/creatives` - Auth: HTTP bearer ## Path parameters - `advertiserId` string, required ## Request body - union - object - `body_text` string: The body text for the new Creative, if any - `business_name` string: The advertiser name for the new creative. - `carousel_cards` object[]: The cards form data for the new creative - `card_type` 'DEFAULT_CARD' | 'LAST_CARD', nullable: The carousel card type. Optional - `cta` string: The card cta text. - `media_id` string: The image id for the new Creative. - `media_type` 'IMAGE' | 'VIDEO': The card media type (image or video). - `offer_text` string, nullable: The card offer text. - `post_click_action` object: Post click action for the card. - `clickthrough_url` string: A clickthrough url for the creative - `slot_index` integer: The slot index for the card order. - `headline` string: The headline text for the new Creative. - `logo_image_id` string: The logo image id for the new Creative. - `name` string: The name of the new creative. - `placement` 'FEED': The placement for the new creative. - `post_click_action` object: Post click action for the new creative. - `clickthrough_url` string: A clickthrough url for the creative - object - `body_text` string: The body text for the new creative. - `business_name` string: The advertiser name for the new creative. - `canvas_image_id` string: The canvas image id for the new creative. - `click_tracking_urls` string[], nullable: A list of click tracking urls. optional. - `cta` string: The call to action chosen for the new creative. - `headline` string: The headline text for the new creative. - `impression_tracking_urls` string[], nullable: A list of impression tracking urls. optional. - `logo_image_id` string: The logo image id for the new creative. - `name` string: The name of the new creative. - `offer_text` string, nullable: The offer text for the creative, if any. - `placement` 'FEED': The placement for the new creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - `fields` object[]: Fields for lead-gen form - `label` string - `type` 'NAME' | 'ADDRESS' | 'EMAIL' | 'PHONE_NUMBER' | 'ZIPCODE' | 'CUSTOM' | 'MULTIPLE_CHOICE' - `required` boolean - `choices` string[] - `post_submit_properties` object: Properties around what should happen post submit - `title` string - `message` string - `cta` object - … - `privacy_policy_link` string: Privacy policy regarding data input into form - object - `clickthrough_url` string: A clickthrough url for the creative - object - `business_name` string: The advertiser name for the new creative. - `canvas_image_id` string: The canvas image id for the new creative. - `click_tracking_urls` string[], nullable: A list of click tracking urls. optional. - `headline` string: The headline text for the new creative. - `impression_tracking_urls` string[], nullable: A list of impression tracking urls. optional. - `logo_image_id` string: The logo image id for the new creative. - `name` string: The name of the new creative. - `placement` 'FSF': The placement for the new creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `price` string, nullable: The price for the new creative. - object - `business_name` string: The advertiser name for the new creative. - `canvas_image_id` string: The canvas image id for the new creative. - `click_tracking_urls` string[], nullable: A list of click tracking urls. optional - `cta` string: The call to action chosen for the new creative. - `headline` string: The headline text for the new creative. - `impression_tracking_urls` string[], nullable: A list of impression tracking urls. optional. - `logo_image_id` string: The logo image id for the new creative. - `name` string: The name of the new creative. - `offer_text` string, nullable: The offer text for the creative, if any. - `placement` 'RHR': The placement for the new creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - object - `body_text` string: The body text for the new Creative, if any - `business_name` string: The advertiser name for the new creative. - `click_tracking_urls` string[], nullable: A list of click tracking urls. optional - `cta` string: The call to action chosen for the new Creative, if any - `headline` string: The headline text for the new Creative. - `impression_tracking_urls` string[], nullable: A list of impression tracking urls. optional - `logo_image_id` string: The logo image id for the new Creative. - `name` string: The name of the new creative. - `offer_text` string, nullable: The offer text for the creative, if any. - `placement` 'FEED': The placement for the new creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - `fields` object[]: Fields for lead-gen form - `label` string - `type` 'NAME' | 'ADDRESS' | 'EMAIL' | 'PHONE_NUMBER' | 'ZIPCODE' | 'CUSTOM' | 'MULTIPLE_CHOICE' - `required` boolean - `choices` string[] - `post_submit_properties` object: Properties around what should happen post submit - `title` string - `message` string - `cta` object - … - `privacy_policy_link` string: Privacy policy regarding data input into form - object - `clickthrough_url` string: A clickthrough url for the creative - `video_id` string: The video id for the new Creative. ## Response `200` The newly created creative - union - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string: The body text for the creative. - `business_name` string: The creative's advertiser name - `carousel_card` union[]: The metadata of the carousel creative card. - union - object - `card_type` 'DEFAULT_CARD' | 'LAST_CARD': The type of carousel card. - `cta` string: The click to action text of the card. - `id` string: The id of the card's canvas image. - `media_type` 'IMAGE': The media type for this card. - `offer_text` string, nullable: The offer text of the card - `post_click_action` object: Post click action for the card. - `clickthrough_url` string: A clickthrough url for the creative - `public_url` string: The public url of the card's canvas image. - `slot_index` integer: The slot index for this card. - object - `card_type` 'DEFAULT_CARD' | 'LAST_CARD': The type of carousel card. - `cta` string: The click to action text of the card. - `media_type` 'VIDEO': The media type for this card. - `offer_text` string, nullable: The offer text of the card - `post_click_action` object: Post click action for the card. - `clickthrough_url` string: A clickthrough url for the creative - `slot_index` integer: The slot index for this card. - `thumbnail_url` string: The thumbnail public url of the creative. - `video_id` string: The id of the creative's video. - `video_url` string: The public url of the creative's video. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'CAROUSEL': The type of this creative - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'FEED': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'FSF_IMAGE': The type of this creative - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `price` string, nullable: Price displayed on the creative. - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string, nullable: The body text for the creative, if any. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'FEED_IMAGE': The type of this creative - `cta` string, nullable: The call to action chosen for the creative, if any - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - `fields` object[]: Fields for lead-gen form - `label` string - `type` 'NAME' | 'ADDRESS' | 'EMAIL' | 'PHONE_NUMBER' | 'ZIPCODE' | 'CUSTOM' | 'MULTIPLE_CHOICE' - `required` boolean - `choices` string[] - `post_submit_properties` object: Properties around what should happen post submit - `title` string - `message` string - `cta` object - … - `privacy_policy_link` string: Privacy policy regarding data input into form - object - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'RHR_IMAGE': The type of this creative - `cta` string, nullable: The call to action chosen for the creative, if any - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string: The body text for the creative. - `business_name` string: The creative's advertiser name - `click_tracking_urls` string[]: A list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'VIDEO': The type of this creative - `cta` string: The call to action chosen for the creative. - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `offer_text` string, nullable: The offer text for the creative, if any. - `placement` 'FEED': The placement for the creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - `fields` object[]: Fields for lead-gen form - `label` string - `type` 'NAME' | 'ADDRESS' | 'EMAIL' | 'PHONE_NUMBER' | 'ZIPCODE' | 'CUSTOM' | 'MULTIPLE_CHOICE' - `required` boolean - `choices` string[] - `post_submit_properties` object: Properties around what should happen post submit - `title` string - `message` string - `cta` object - … - `privacy_policy_link` string: Privacy policy regarding data input into form - object - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `thumbnail_url` string: The thumbnail public url of the creative. - `updated_at` string, date-time: The update time of the creative - `video_id` string: The id of the creative's video. - `video_url` string: The public url of the creative's video. ## Other responses - `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input. - `401`: Unauthorized. The API key is invalid and needs to be re-generated. - `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions. - `500`: Internal server error. - `503`: The server is temporarily unable to handle the request due to maintenance or overload. --- [API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)