Skip to main content
POST
Create Account
Creates an additional business or individual account under the same owner as your API key’s business. The new account starts as a draft application that you complete with the other account onboarding endpoints.
White-label partners only. The entire account onboarding API (this endpoint and everything under /accounts) is available only to businesses activated as white-label tenants. A non-tenant API key receives 403 Forbidden.

Example Request

Business account

Individual account

Example Response

Parameters

email is required and must be unique. Omitting it returns 400. Creating a second account with the same email under your business returns 409 Conflict with code: "ACCOUNT_EMAIL_EXISTS".
An email on Rolla’s blocklist is refused with 403 and code: "EMAIL_BLOCKLISTED":
This is separate from the white-label 403 above, which has no code. Branch on code, not on the status alone.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Body

application/json
type
enum<string>
required

Type of account to create

Available options:
business,
individual
Example:

"business"

email
string<email>
required

The account's own contact email. Required, and must be unique across your accounts — every account you onboard is a distinct customer with its own email

Example:

"ops@betalogistics.com"

name
string

Business name. Required when type is business, ignored for an individual account

Minimum string length: 1
Example:

"Beta Logistics LLC"

firstName
string

Account holder first name (individual accounts). Defaults to the owner's name

Minimum string length: 1
Example:

"Jane"

lastName
string

Account holder last name (individual accounts). Defaults to the owner's name

Minimum string length: 1
Example:

"Doe"

Response

Account created successfully

status
integer
required
Example:

201

message
string
required
Example:

"Account created successfully"

success
boolean
required
Example:

true

data
object
required