Skip to main content
PATCH
Update customer
Required scope: customers:write Rate limit: 60 requests/minute Idempotency: supported – pass Idempotency-Key to safely retry. See Idempotency. Only first_name and last_name are updatable through this endpoint. Email changes are not currently supported via the Developer API – change them through the in-app dashboard, which handles the de-duplication and audit flow.

Path parameters

Request body

A field set to null is treated the same as omitting it – fields are only written when explicitly provided with a non-null value. A PATCH with an empty body ({}) or with both fields omitted is a no-op and still returns 200 with the unchanged customer.

Response

Errors

  • 404 – Customer not found in your tenant.
  • 409Idempotency-Key reused with a different request body within the 24h replay window (see Idempotency).
  • 422 – Validation error (e.g. name longer than 255 characters).

Examples