For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Customer already exists

A customer with this email address already exists in your account.

Example response
{
"error": {
"type": "request_error",
"code": "customer_already_exists",
"detail": "Customer email conflicts with existing customer ID ctm_01ghbk4xjn4qdsmstcwzgcgg35.",
"documentation_url": "https://developer.paddle.com/errors/customers/customer_already_exists"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
409
Error code
customer_already_exists
Error message
Customer email conflicts with existing customer ID %s.

Common causes

  • Another customer already uses this email. Email addresses are unique regardless of letter case, and archived customers still count.
  • You're updating a customer's email to an address that another customer already uses.
  • Multiple requests to create a customer with the same email address were made.
  • A third-party integration you authorized may be trying to create a customer that already exists.

Troubleshooting

  • Get the ID of the existing customer from the error detail and use that for subsequent requests.
  • To find the existing customer, list customers using the email query parameter with status=active,archived. Archived customers aren't returned by default.
  • If the existing customer is archived, set its status to active to use it again.
  • Don't send multiple requests to create a customer with the same email address.

Was this page helpful?