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

Create Ad Account

Create Ad Account.

Request

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

name
string
Required
Name given to identify your account.
Pattern: ^(?!\s).+(?<!\s)$Length between 1 and 120Example: "Account Name"
type
string
Required
Allowed values: "AD_AGENCY", "BRAND_ADVERTISER", "MUSIC_LABEL", "CONCERT_PROMOTER", "ARTIST", "MANAGER", "PUBLISHER"
industry
string
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_code
string
Required
The country or region of the geo in ISO alpha-2 country code format.
Example: "US"
legal_entity_name
string
The legal name of the entity funding ads for the ad account.
Example: "Spotify AB"
website
string
The website associated with the ad account.
Example: "https://www.spotify.com"

Response

Metadata of business' permission to an ad account.

id
string [uuid]
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
business_id
string [uuid]
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
created_at
string [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_at
string [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_code
string
The country or region of the geo in ISO alpha-2 country code format.
Example: "US"
industry
string
The Ad Account's listed industry.
Example: "Media & Entertainment"
website
string
The website associated with the ad account.
Example: "https://www.spotify.com"
- name
  string
  Billing name for the account that will appear on bills and invoices.
  Pattern: ^\S.*\S$Length between 2 and 120Example: "Entity_1"
- street
  string
  Street number and address of ad account.
  Example: "123 Spotify Avenue"
- city
  string
  city of ad account
  Example: "Los Angeles"
- region
  string
  Region where city is located.
  Example: "California"
- postal_code
  string
  Postal code for address.
  Example: "90210"
- tax_region
  string
  Geo in ISO alpha-2 country code format for taxable country.
  Example: "ES"
legal_entity_name
string
The legal name of the entity funding ads for the ad account.
Supported content-type(s): Example: "Spotify AB"
status
string
The status of the ad account.
Allowed values: "ACTIVE", "INACTIVE", "GREY_LISTED", "SUSPEND_LISTED", "BLACKLISTED"
status_reason
string
The reason for the status of the ad account.
name
string
Name given to identify your account.
Pattern: ^\S.*\S$Example: "Nike SB"
ad_account_role
string
The role of a user in an ad account.
Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"
tax_id
string
The tax ID on record for the ad account.
Example: "ATU82660371"
currency_code
string
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"}