Skip to main content
POST
/
products
Create a product
curl --request POST \
  --url https://www.merchkit.com/api/v1/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "parent_entity": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attributes": {}
}
'

Authorizations

Authorization
string
header
required

Workspace-scoped API key. Available scopes:

  • read:products: List and read products, assets, vendors, sources, and merch.
  • write:products: Create and update products and their attribute values.
  • delete:products: Delete products.
  • read:attributes: List and read attribute definitions.
  • write:attributes: Create, update, and delete attribute definitions.
  • write:attribute_values: Set attribute values on entities.
  • read:views: List and read saved grid views.
  • write:views: Create and update grid views.
  • read:vendors: List and read vendor records.
  • write:vendors: Create and update vendor records.
  • read:categories: List and read categories.
  • write:categories: Create and update categories.
  • read:channels: Read the available channel catalog.
  • read:completeness: Check per-channel completeness for entities.
  • read:history: Read entity history and the account change feed.
  • read:jobs: Poll asynchronous job status.
  • data:import: Start import operations.
  • data:export: Start export operations.

Body

application/json
parent_entity
string<uuid>
attributes
object

Response

201

The created product.