Skip to main content
POST
Create customer
Required scope: customers:write Rate limit: 60 requests/minute Status code on success: 201 Created Idempotency: supported – pass Idempotency-Key to safely retry. See Idempotency.

Request body

PII fields are stored encrypted at rest with deterministic lookup hashes used for de-duplication.

Response

Errors

  • 409 "Customer with this email already exists" – a customer with that email already exists in your tenant. Look up the existing record via GET /developer/customers?search={email}.
  • 409 "Idempotency-Key was reused with a different request body. Use a fresh Idempotency-Key for a different operation." – the supplied Idempotency-Key was reused with a different request body within the 24h replay window. See Idempotency.
  • 409 "A duplicate request is already being processed. Please wait a moment and try again." – a request with the same Idempotency-Key is still in flight. Retry shortly.
  • 422 – Validation error (e.g. malformed email).

Examples