Create client

Starts onboarding of an individual or business client. Build the request body from the schema returned by
GET /baas/Clients/fields for the same client type: the set of fields depends on the configuration of your
integration. The body must contain type (individual or business), your externalId of the client and
the fields required by the schema; email, firstName and lastName are required for both client types.

The response contains the client identifier; the client starts in the pending state. Onboarding, including
identity verification, completes asynchronously and is reported with an onboardingCompleted or
onboardingFailed webhook; you can also poll GET /baas/Clients/{id}/state. Open accounts only after the
client becomes active.

Repeating the request with the same externalId returns the identifier of the existing client without
changing its data.

Errors:

403 Forbidden - your integration is not allowed to create clients of this type;

409 Conflict - the client conflicts with an existing one.

Request

Request Code Samples

Responses