Create Corporate Account with Legal Representative

Creates a new legal entity account by providing the entity’s details along with information about its legal representative. This request is typically the first step before initiating the onboarding process. Once created, the account will have an initial status (e.g., CREATED) and a profile status (e.g., AWAITING_INFORMATION)

Validation Rules

Validation Notes

  • Birth date (legalRepresentative.birthDate): the year must be 1920 or later. An earlier year returns 500 with year of birth cannot be less than 1920.
  • Country codes: use ISO 3166-1 alpha-2 codes. Use GB for the United Kingdom: UK is rejected with 400.

The full list of messages is on the Onboarding API: Error Messages page.

Body Params
string
enum

Activity code or category for the legal entity (e.g., type of business)

legalEntity
object
required

Details about the legal entity (see nested bodyParams)

legalRepresentative
object
required

Information about the entity’s legal representative (see nested bodyParams).

string
enum
required

User profile type

string

Wallet identifier

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json