Skip to main content
Programmatic equivalent of the dashboard’s products/new/ page. Use this instead of driving that form when you already have the product’s GTIN and core details.

​
When to use

  • A brand owner (or an agent acting on their behalf) needs to add a new GTIN to Closient and claim it for their organization.
  • The GTIN does not already exist on Closient. If it does, use POST /products/api/v1/products/{gtin}/claim instead — this endpoint returns 409 for an existing GTIN.

​
Auth

X-API-Key header or OAuth token with products:write scope. The caller must be a member of the organization named by organization_id.

​
Flow

Body (JSON): Returns 201 with the created ProductOut on success, 403 if the caller lacks a role on organization_id, 409 if the GTIN is already claimed, 422 for a malformed GTIN or a banned consumer date-label phrase in a free-text field (AB 660).

​
Notes

  • Every other field the dashboard exposes (dimensions, GPC classification, images, nutrition, documents, videos) is added afterward via the sibling skills — edit-product-basic-info, edit-product-dimensions, edit-product-classification, edit-product-images, edit-product-ingredients, edit-product-nutrition, edit-product-documents, edit-product-videos.