Skip to main content

​
Endpoint

  • Method: POST
  • URL: {{ACCOUNT_URL}}/v1/ext/account/create-user
  • Auth: Bearer {{accessToken}}
Same endpoint as end-user creation. Use type: "BUSINESS" and include businessName.

​
Request Body

FieldTypeDescriptionRequired
businessNamestringLegal/operating name of businessYes
emailstringContact emailYes
identifierstringYour unique business identifierYes
typestringMust be BUSINESSYes

​
Example Request

curl -X POST "{{ACCOUNT_URL}}/v1/ext/account/create-user" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Gradientfi Inc",
    "email": "billing@gradientfi.com",
    "identifier": "biz-001",
    "type": "BUSINESS"
  }'

​
Response (200)

{
  "message": "User account created",
  "account": {
    "id": "NmFkZWQyYTYtMGY5Yy00YTVkLWJhYWYtNTZiMTVkMzg0ZTQ1"
  }
}

​
Error (400 - Account Exists)

{
  "message": "An account with the given email already exists.",
  "fatal": true
}

​
Notes

  • The returned account.id is the entityId used in wallet and payment APIs.
  • Use distinct identifier values per business to avoid collisions.