Register a customer

post

https://sandbox.notabene.id/api/v1/customers

Registers a customer you have a direct relationship with, so they can be named as the originator or beneficiary of a transaction.

Required permission: create:customer.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Used in these guides:

Customers › Register a customer
Customers › An organization
Customers › Your customers and the counterparties’ customers

Responses

429

Too Many Requests: more than 6,000 calls in 300 seconds. Every endpoint refuses your calls for the next 10 seconds. Send the request again with a backoff, as Rate limiting explains.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

201Created

400Bad Request. A missing or invalid field or parameter is listed under errors, with the field when it can be named. Any other reason comes as a problem document, with the reason in detail.

401Unauthorized: the access token is missing, malformed or expired. Request a new one, as Authentication explains.

403Forbidden: the token cannot make this call. It lacks the permission named above.

409Conflict: a customer with this id already exists, so a retry never creates a second record.

defaultAny other error, as a problem document.