Creates an advertiser that is tied to the NAM profile the API credentials are tied to

post

https://ads.nextdoor.com/api/v3/advertisers

Body Params

address

object | null

The address to be used for this advertiser.
All inputs are required except for the "street_address_2" field which is optional;
this represents additional information like an apartment or suite number.

business_category

object

The business category to be used for this advertiser.

country

string

enum

The Country to be used for this advertiser

Allowed:

currency

string

The Currency unit to use for the new advertiser.
currencies are represented by their ISO-4217 currency codes (e.g. "USD" or "BRL").

default_business_name

string | null

The default business name to be used for this advertiser.

name

string

The name to use for the new advertiser.

timezone

string

The advertiser's timezone id, timezones are represented as either:

Fixed offsets, e.g. "-07:00", "UTC+05:00"
Geographical regions, e.g. "America/Los_Angeles"

web_scraping_opt_in

boolean

Web scraping opt-in status

website_url

string | null

The website url to be used for this advertiser.

Responses

Language

Credentials

http

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The newly created advertiser profile

400Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.

401Unauthorized. The API key is invalid and needs to be re-generated.

403Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.

500Internal server error.

503The server is temporarily unable to handle the request due to maintenance or overload.