Skip to main content

​
When to use

Use this when onboarding a business customer. The returned account.id (entityId) is used for wallets, payouts, and linked accounts.

​
Endpoint

  • POST {{ACCOUNT_URL}}/v1/ext/account/create-user
  • Auth: Bearer {{accessToken}}

​
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"
  }'

​
Fields

FieldTypeDescriptionRequired
businessNamestringLegal/operating business nameYes
emailstringContact emailYes
identifierstringYour unique business identifierYes
typestringMust be BUSINESSYes

​
Success Response (200)

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

​
Error (400 - Account Exists)

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

​
Next steps

  • Save account.id as entityId.
  • Create wallets for this business.
  • Use entityId when creating payout/payment links tied to the business.