SupDesk
POST/v1/customers

Create or resolve a customer

Creates a customer or resolves an existing customer by email. Supply email in a valid email format; a repeat request with the same address returns the existing customer.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

Customer details used to create or resolve a customer by email.

emailstringrequired
The customer's email address in a valid email format; used to match an existing customer.
namestringoptional
The customer's name.

2 status codes
201Returns the created or matched customer in the `data` object.
dataobjectoptional
401Returned when the request is unauthenticated or authentication is invalid.
errorobjectoptional

Error handling

A 401 is returned when the request lacks valid authentication. email is required and must use a valid email format.