Ads API •References / businesses / Create Business
Create Business
Creates a new business
Request
POST
/businesses
- namestringRequired
The name of the business.
Pattern:^(?!\s*$).+Length between1and95Example:"My Ad Studio Business" - business_admin_namestringRequired
The display name of a user in or invited to a business. It will be defined for active users, and null for pending users.
Example:"John Doe" - business_admin_emailstringRequired
The email address of a user in or invited to a business.
Maximum length:319Example:"discovery@gmail.com" - typestring
The type of the business.
Allowed values:"ADVERTISER","AGENCY","MUSIC_ARTIST_CONCERT_PROMOTER","PODCAST_PROMOTER" - business_admin_has_marketing_opt_inbooleanRequired
Indicates if user has opted into marketing.
Response
A business object.
- idstring [uuid]
A unique identifier for the entity.
Example:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a" - namestring
The name of the business.
Pattern:^(?!\s*$).+Length between1and95Example:"My Ad Studio Business" - 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" - statusstring
The status of the business.
Allowed values:"ACTIVE" - typestring
The type of the business.
Allowed values:"ADVERTISER","AGENCY","MUSIC_ARTIST_CONCERT_PROMOTER","PODCAST_PROMOTER"
Response sample
{ "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "name": "My Ad Studio Business", "created_at": "2026-01-23T04:56:07Z", "updated_at": "2026-01-23T04:56:07Z", "status": "ACTIVE", "type": "ADVERTISER"}