Status 409
The external ID is taken
external_id_in_use
When it happens
The external ID is already used by another live record of this app; external_id names it.
What to do
Read the record by its external ID and update it, or choose another ID.
Can’t find the answer, or the error keeps coming back? Write to us and quote the X-Request-Id from the response so we can find the request. Contact us
Endpoints that return it
- post
/categoriesCreate a catalog category - patch
/categories/{category}Change a catalog category - post
/productsCreate a product with its variants - patch
/products/{product}Change a product card: fields, categories, external ID - patch
/products/by-external-id/{external_id}Create or update a product with its variants by its external ID - post
/variantsAdd a variant to a product - patch
/variants/{variant}Update a product variant - post
/modifier-groupsCreate a modifier group with options - patch
/modifier-groups/{group}Update a modifier group and its option set - patch
/modifier-groups/by-external-id/{external_id}Create or update a modifier group by external ID - post
/customersCreate a customer: a name and at least one contact - patch
/customers/{customer}Update a customer's name, language and external ID - post
/suppliersCreate a supplier: tax details and payment terms - patch
/suppliers/{supplier}Update a supplier's tax details, payment terms and external ID
Response body
application/problem+json · ConflictProblem
typestringrequiredMachine type of the problem: a stable code to branch on, such as insufficient_scope. Every type has a page in the error catalog.
titlestringrequiredShort summary of the problem in the language of the request.
statusintegerrequiredHTTP status of the response.
detailstringExplanation of this occurrence in the language of the request.
currentobjectThe record as it is now, the fields the conflict is about: on_hand for stock_on_hand_changed, status for rejected order changes, status and order_id for a closed draft.
external_idstringFor external_id_in_use and external_id_archived — the taken external ID.
consent_kindstringFor consent_required — the kind of consequence to agree to.
consequencesmap of integerFor consent_required — what will change: kind of data → number of records.
- Minimum:
- 0
consent_tokenstringFor consent_required — fingerprint of the shown consequences. Repeat the request with consent[<consent_kind>]=<consent_token>.
variant_idintegerFor consent_required of a variant line in a product write — the variant: the consent is given by changing that variant (PATCH /v1/variants/{variant}).
limitintegerFor plan_limit_reached, address_book_full, bulk_operation_queue_full and webhook_endpoint_limit_reached — the limit.
- Minimum:
- 0
fieldstringFor customer_contact_in_use — the contact that belongs to another customer: phone or email.
- Values:
phoneemail
existing_customer_idintegerFor customer_contact_in_use — the customer the contact belongs to.
receivedintegerFor upload_offset_mismatch — bytes the upload has received: the offset to continue from.
- Minimum:
- 0
operation_statusstringFor bulk_operation_finished — the status the operation finished with.