Skip to main content
POST
Create a company

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Body

application/json

Create an agency subaccount under the token tenant. The token is confined to one company, so parentCompanyId is required and must equal your own company id (the server rejects anything else). Only an agency-parent caller may create subaccounts. Unrecognized fields are passed through.

name
string
required

Subaccount company name (required).

Minimum string length: 1
phone
string
required

Company phone number (required).

Minimum string length: 1
parentCompanyId
string
required

Parent agency id — must equal the token tenant's company id; OAuth clamps it to your own company.

privacyPolicyAccepted
boolean
required

Must be true — the owner accepts the privacy policy.

termsOfServiceAccepted
boolean
required

Must be true — the owner accepts the terms of service.

website
string

Company website URL.

appstoreUrl
string

Company App Store URL.

category
string

Company category.

companyStage
string

Company stage (e.g. 'seed', 'growth').

hireRange
string

Company hiring range.

companyNiche
string

Company niche.

address
object

Company address.

instagram
string

Instagram handle.

linkedin
string

LinkedIn URL.

tiktok
string

TikTok handle.

profileImageUrl
string

Company profile image URL.

createRequestId
string

Optional idempotency key for subaccount creation (8-128 chars, [A-Za-z0-9_-]); enables idempotent retries.

Response

The created agency subaccount's id, Stripe customer id, and billing flags. (Route returns HTTP 201; manifest successCode is 200.)

data
object
required

Result of creating an agency subaccount.