Ads API •References / businesses / Create Business
Create Business
Creates a new business
Request
POST
/businesses
- namestringRequired
The name of the business.
Pattern:^(?!\s*$).+
Length between1
and95
Example:"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:319
Example:"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 between1
and95
Example:"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"}