Skip to main content
POST
Create a business

Authorizations

Authorization
string
header
required

Authenticate with your secret API key as a bearer token: Authorization: Bearer 3r_live_.... Keys are issued per partner from the dashboard; use 3r_test_... against the sandbox. Never expose a secret key in client-side code.

Headers

Idempotency-Key
string

A unique key (e.g. a UUID) that makes a write safe to retry. Replaying the same key returns the original result instead of creating a duplicate.

Maximum string length: 255

Body

application/json
name
string
required
Example:

"Bluewave Logistics Ltd"

country
string
required

ISO 3166-1 alpha-2 country code.

Example:

"NG"

baseCurrency
string
required

ISO 4217 currency code for the books.

Example:

"NGN"

industry
string

Used to pick a chart-of-accounts template.

Example:

"logistics"

externalId
string

Your own identifier for this business; returned on every record.

Example:

"cust_8812"

Response

Business created.

id
string
required
Example:

"biz_9f2"

name
string
required
Example:

"Bluewave Logistics Ltd"

country
string
required
Example:

"NG"

baseCurrency
string
required
Example:

"NGN"

createdAt
string<date-time>
required
Example:

"2026-11-08T09:20:00Z"

industry
string
Example:

"logistics"

externalId
string
Example:

"cust_8812"