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

Update Ad Account

Update an ad account

Request

ad_account_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

name
string
Name given to identify your account.
Pattern: ^\S.*\S$Length between 2 and 120Example: "Account Name"
industry
string
Allowed values: "AUTOMOTIVE", "CPG", "EDUCATION_TRAINING", "ENERGY_UTILITIES", "FINANCIAL_REAL_ESTATE", "GOVERNMENT_NON_PROFIT", "MEDIA_ENTERTAINMENT", "MEDICAL_PHARMACEUTICAL", "POLITICAL", "RESTAURANTS_FOOD_SERVICE", "RETAILER_WHOLESALE", "TECHNOLOGY", "TELECOMMUNICATIONS", "TRAVEL_LEISURE", "OTHER"
- name
  string
  Billing name for account.
  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"
tax_id
string
The tax ID on record for the ad account.
Example: "ATU82660371"
legal_entity_name
string
The legal name of the financing party of the ad account.
Example: "Spotify AB"

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 account.
  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 financing party of 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"
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"
tax_id
string
The tax ID on record for the ad account.
Example: "ATU82660371"
tax_status
string
The validation status of the tax ID.
Allowed values: "VALID", "PROCESSING", "INVALID", "UNKNOWN"Example: "VALID"

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",  "tax_id": "ATU82660371",  "tax_status": "VALID"}