Skip to main content
POST
Create a business

Authorizations

Authorization
string
header
required

OAuth 2.0 Bearer Token from Clerk authentication

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Body

application/json
book_id
string
required

The book ID

Example:

"abc123xyz"

name
string
required

Business name

Example:

"Acme Corp"

industry
string

Industry

Example:

"Technology"

website_url
string

Website URL

Example:

"https://acme.com"

tax_id
string

Tax ID

Example:

"12-3456789"

additional_info
string

Additional information

email_addresses
object[]

Array of email addresses

phone_numbers
object[]

Array of phone numbers

addresses
object[]

Array of addresses

tag_ids
string[]

Array of tag IDs to associate

Response

business created

id
string
required

The business ID

Example:

"abc123xyz"

book_id
string
required

The book ID

Example:

"book123xyz"

name
string
required

Business name

Example:

"Acme Corp"

created_at
string<date-time>
required

When the business was created

updated_at
string<date-time>
required

When the business was last updated

industry
string | null

Industry

Example:

"Technology"

website_url
string | null

Website URL

Example:

"https://acme.com"

tax_id
string | null

Tax ID

Example:

"12-3456789"

additional_info
string | null

Additional information

email_addresses
object[]

Array of email addresses

phone_numbers
object[]

Array of phone numbers

addresses
object[]

Array of addresses

tags
object[]

Array of tags