Ads API •References / ad-accounts / Create Ad Account

Create Ad Account

Create Ad Account.

Request

business_idstring [uuid]
Required
A unique identifier for the entity.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

- namestring
  Billing name for the account that will appear on bills and invoices.
  Pattern: ^\S(.*\S)?$Length between 1 and 120Example: "Entity_1"
- streetstring
  Street number and address of ad account.
  Example: "123 Spotify Avenue"
- citystring
  city of ad account
  Example: "Los Angeles"
- regionstring
  Region where city is located.
  Example: "California"
- postal_codestring
  Postal code for address.
  Example: "90210"
- tax_regionstring
  Geo in ISO alpha-2 country code format for taxable country.
  Example: "ES"
- idstring
  The tax ID on record for the ad account.
  Example: "ATU82660371"
- typestring
  The tax ID type
  Allowed values: "VAT", "GST", "QST", "ABN", "CNPJ", "PAN", "TAN", "NZBN"
currency_codestring
The billing currency for the account
Maximum length: 3Example: "USD"
namestring
Required
Name given to identify your account.
Pattern: ^(?!\s).+(?<!\s)$Length between 1 and 120Example: "Account Name"
typestring
Required
Allowed values: "AD_AGENCY", "BRAND_ADVERTISER", "MUSIC_LABEL", "CONCERT_PROMOTER", "ARTIST", "MANAGER", "PUBLISHER"
industrystring
Required
Allowed values: "AGENCY", "AUTO", "AUTOMOTIVE", "BUSINESS_SERVICES_INDUSTRIALS", "CPG", "EDUCATION_TRAINING", "ENERGY_UTILITIES", "FINANCE", "FINANCIAL_REAL_ESTATE", "FOOD_DINING_SERVICES", "GAMING", "GOVERNMENT_NON_PROFIT", "HEALTH_WELLNESS", "JOBS_EDUCATION", "LAW_GOVERNMENT_POLITICAL_NON_PROFIT", "MEDIA_ENTERTAINMENT", "MEDICAL_PHARMACEUTICAL", "OTHER", "POLITICAL", "RESTAURANTS_FOOD_SERVICE", "RETAIL", "RETAILER_WHOLESALE", "TECHNOLOGY", "TELECOM", "TELECOMMUNICATIONS", "TRAVEL_LEISURE", "TRAVEL_TOURISM"
country_codestring
Required
The country or region of the geo in ISO alpha-2 country code format.
Example: "US"
legal_entity_namestring
The legal name of the entity funding ads for the ad account.
Example: "Spotify AB"
websitestring
The website associated with the ad account.
Example: "https://www.spotify.com"

Response

Metadata of business' permission to an ad account.

idstring [uuid]
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
business_idstring [uuid]
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
created_atstring [date-time]
Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example: "2026-01-23T04:56:07Z"
updated_atstring [date-time]
Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example: "2026-01-23T04:56:07Z"
country_codestring
The country or region of the geo in ISO alpha-2 country code format.
Example: "US"
industrystring
The Ad Account's listed industry.
Example: "Media & Entertainment"
websitestring
The website associated with the ad account.
Example: "https://www.spotify.com"
- namestring
  Billing name for the account that will appear on bills and invoices.
  Pattern: ^\S(.*\S)?$Length between 1 and 120Example: "Entity_1"
- streetstring
  Street number and address of ad account.
  Example: "123 Spotify Avenue"
- citystring
  city of ad account
  Example: "Los Angeles"
- regionstring
  Region where city is located.
  Example: "California"
- postal_codestring
  Postal code for address.
  Example: "90210"
- tax_regionstring
  Geo in ISO alpha-2 country code format for taxable country.
  Example: "ES"
legal_entity_namestring
The legal name of the entity funding ads for the ad account.
Supported content-type(s): Example: "Spotify AB"
statusstring
The status of the ad account.
Allowed values: "ACTIVE", "INACTIVE", "GREY_LISTED", "SUSPEND_LISTED", "BLACKLISTED"
status_reasonstring
The reason for the status of the ad account.
namestring
Name given to identify your account.
Pattern: ^\S.*\S$Example: "Nike SB"
ad_account_rolestring
The role of a user in an ad account.
Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"
tax_idstring
The tax ID on record for the ad account.
Example: "ATU82660371"
currency_codestring
The billing currency for the account
Maximum length: 3Example: "USD"

Response sample

{  "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "business_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "country_code": "US",  "industry": "Media & Entertainment",  "website": "https://www.spotify.com",  "billing_address": {    "name": "Entity_1",    "street": "123 Spotify Avenue",    "city": "Los Angeles",    "region": "California",    "postal_code": "90210",    "tax_region": "ES"  },  "legal_entity_name": "Spotify AB",  "status": "ACTIVE",  "status_reason": "string",  "name": "Nike SB",  "ad_account_role": "AD_ACCOUNT_ADMIN",  "tax_id": "ATU82660371",  "currency_code": "USD"}