SupDesk API
POST/v1/customers

Create or resolve a customer

Creates a customer or returns the existing customer matched by email. Supply email to identify the customer; repeating a request with the same email 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.

emailstringrequired
The customer's email address, in a valid email format.
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.
errorobjectoptional

Error handling

A 401 is returned when the request is unauthenticated. email is required and must be a valid email address.