Skip to main content
POST
/
accounts
Create Account
curl --request POST \
  --url https://api.rolla.xyz/api/v1/external/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "<string>",
  "firstName": "<string>",
  "lastName": "<string>"
}
'
{
  "success": true,
  "message": "Account created successfully",
  "data": {
    "account": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Beta Logistics LLC",
      "email": "jsmith@example.com",
      "applicationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currentStep": 1,
      "isComplete": true,
      "createdAt": "2023-11-07T05:31:56Z"
    },
    "applicationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "applicationStatus": "draft"
  }
}
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.

​
Example Request

​
Business account

curl -X POST "https://api.rolla.xyz/api/v1/external/accounts" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "business",
    "name": "Beta Logistics LLC"
  }'

​
Individual account

curl -X POST "https://api.rolla.xyz/api/v1/external/accounts" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "individual",
    "firstName": "Jane",
    "lastName": "Doe"
  }'

​
Example Response

{
  "success": true,
  "message": "Account created successfully",
  "data": {
    "account": {
      "id": "eec3cbed-79d8-4370-87a0-b6be9e287337",
      "name": "Beta Logistics LLC",
      "email": "owner@example.com",
      "status": "created",
      "entityType": "business"
    },
    "applicationId": "fbb45236-881a-4c58-8954-22759499eab4",
    "applicationStatus": "draft"
  }
}

​
Parameters

FieldTypeRequiredDescription
typestringYesbusiness or individual
namestringFor businessLegal or trading name of the business
firstNamestringNoAccount holder first name (individual accounts); defaults to the owner’s name
lastNamestringNoAccount holder last name (individual accounts); defaults to the owner’s name

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
​
name
string

Business name. Required when type is business.

​
firstName
string

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

​
lastName
string

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

Response

Account created successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Account created successfully"

​
data
object