Ad

Creates an ad based on the input

post/api/v3/advertisers/{advertiserId}/ads

Request

  • Base URL
    https://ads.nextdoor.com
  • URL
    https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/ads
  • Auth
    HTTP bearer

Path parameters

advertiserIdstring required

The id of the advertiser for which the request is made

Request body

adgroup_idstring

The ad group id to which this ad will be associated with

creative_idstring

The creative id for this ad

namestring

The ad name

Response

The newly created ad

adgroup_idstring

The ad group id to associated with this ad

advertiser_idstring

The advertiser id who owns the ad

created_atstring date-time

The UTC time when this ad was created

creative_idstring

The creative id associated with this ad

idstring

The id of the ad

namestring

The name of the ad

status'ACTIVE' | 'INACTIVE' | 'PENDING' | 'INELIGIBLE' | 'ARCHIVED'

The delivery status of this ad

updated_atstring date-time

The UTC time when this ad was last updated

user_status'ACTIVE' | 'INACTIVE' | 'ARCHIVED'

The status of this ad set by the user

Changes

No recorded changes to this operation across all 1 revision of this API.