Skip to content
Flowkiwi Flowkiwi Docs

Create your first product

View as Markdown

This guide creates a product on an instance you already have.

Prerequisites

Section titled “Prerequisites”

You need an organization and an instance. If you don’t have them yet, follow Create your organization and instance first. From that setup you reuse two values:

  • the organization id - shown as <org_id> in the commands below
  • the instance handle (the tenant in the product service host) - shown as <tenant> below

Before you start

Section titled “Before you start”

You need an OAuth 2.0 bearer token for a partner account. Sign in below: your token is dropped into every command on this page, and you can pick your organization and instance to fill <org_id> and <tenant> too. See Authentication for more.

Sign in to drop your real token into the commands below.
Enter tenant & organization ID manually

Product Management is per-instance: you call it on https://<tenant>.product-management.flowkiwi.net, where <tenant> is your instance handle. The service is organization-scoped, so every request carries the X-Flowkiwi-Organization-Id header with your organization id.

Create a product

Section titled “Create a product”

Send the product title (and any other fields) to the instance’s Product Management host:

Terminal window
curl -X POST 'https://<tenant>.product-management.flowkiwi.net/rest/api/products' \
  -H 'Authorization: Bearer {token}' \
  -H 'X-Flowkiwi-Organization-Id: <org_id>' \
  -H 'Content-Type: application/ld+json' \
  -d '{
    "title": "Organic cotton t-shirt",
    "description": "Soft, breathable t-shirt cut from 100% organic cotton."
  }'

The product is created in draft status with a single default variant, ready to enrich:

{
  "@id": "/rest/api/products/0196f3a0-4444-7000-8000-000000000001",
  "title": "Organic cotton t-shirt",
  "status": "/rest/api/statuses/DRAFT",
  "description": "Soft, breathable t-shirt cut from 100% organic cotton."
}

Next steps

Section titled “Next steps”