CUSTOMER_EXTERNAL_REFERENCE_CONFLICT - Blujay API

HTTP status	Retryable
`409`	No

What happened

Another of your customers already has this external_reference.

How to fix it

Use a different external_reference, or find the existing customer with GET /v1/partner/customers.

Example response

An illustrative example. The message wording and the contents of details vary; branch on error.code.

{
  "status": "error",
  "error": {
    "code": "CUSTOMER_EXTERNAL_REFERENCE_CONFLICT",
    "message": "External reference already used",
    "type": "validation",
    "http_status": 409,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/customer-external-reference-conflict",
    "details": []
  },
  "trace_id": "trc_8f2a1c0e4b7d",
  "timestamp": "2026-10-14T17:30:48.000Z"
}

Still stuck?

Email support@blujay.io with the trace_id from the error response. See Errors for the response format.