---
title: "Creates an advertiser that is tied to the NAM profile the API credentials are tied to"
method: POST
path: "/api/v3/advertisers"
tags: ["Advertiser"]
---

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

`POST /api/v3/advertisers`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers`
- Auth: HTTP bearer

## Request body

- object
  - `address` object, nullable: 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.
    - `street_address` string
    - `street_address_2` string
    - `city` string
    - `state` string
    - `postal_code` string
    - `country` string
    - `coordinates` object
      - `latitude` number, double
      - `longitude` number, double
  - `business_category` object: The business category to be used for this advertiser.
    - `category_id` string: The business category id to be used for this advertiser.
    - `subcategory_ids` string[]: The business subcategory ids to be used for this advertiser.
  - `country` 'US' | 'CA' | 'GB': The Country to be used for this advertiser
  - `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, nullable: 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, nullable: The website url to be used for this advertiser.

## Response `200`

The newly created advertiser profile

- object
  - `account_balance` string: The current account balance for this advertiser. represented as a string with an ISO-4217 currency code, followed by a space, followed by the numerical amount (e.g. "USD 25.00").
  - `address` object, nullable: The address set for this advertiser.
    - `street_address` string
    - `street_address_2` string
    - `city` string
    - `state` string
    - `postal_code` string
    - `country` string
    - `coordinates` object
      - `latitude` number, double
      - `longitude` number, double
  - `bill_to_payment_profile_id` string, nullable: The bill to payment profile id set for this advertiser.
  - `billing_limit` string: The billing limit set for this advertiser.
  - `categories` string[]: The business categories, if available, set for this advertiser.
  - `country` 'US' | 'CA' | 'GB': The ISO country code string set for this advertiser.
  - `currency` string: The ISO currency code set for this advertiser.
  - `id` string: The id of this advertiser
  - `name` string: The name of this advertiser
  - `payment_profile_id` string, nullable: The payment profile id for this advertiser.
  - `profile_id` string: The id of the profile that owns this advertiser
  - `timezone` string: The timezone identifier string set for this advertiser
  - `web_scraping_opt_info` object, nullable: Web scraping opt info for this advertiser
    - `last_web_scraping_opt_out_timestamp` integer, nullable: User web scraping image feature last opt out time (epoch millis)
    - `web_scraping_opt_in` boolean, nullable: User web scraping image feature opt in status
  - `website_url` string, nullable: The website url set for this advertiser

## 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)