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 and pick your organization and instance: an access token scoped to that instance is generated and dropped into every product-management command on this page. 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 organization context is carried inside the access token.

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 {access_token}' \
  -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”