Create Product

Use this endpoint to create a new product in the store.

The Create Product endpoint supports multiple product classes, including standard products, grouped products, vouchers, downloadable products, crowdfunding projects, donation items, customizable products, and dynamic bundle products.

Some product classes require additional fields in the request body. Dynamic Bundle products require an additional step after product creation to configure selection groups.

Supported product classes

Product Class	Use Case	Additional Step Required
Standard Product	Regular physical or digital product.	No
`grouped_product`	Bundle multiple existing products together as one product.	No
`voucher`	Digital voucher, gift card, or license key product.	May require voucher setup after product creation.
`downloadable`	Digital file product.	Files are managed separately after product creation.
`crowdfunding_project`	Fundraising product with goal tracking.	No
`donation_item`	Donation product with unit-based progress tracking.	No
`dynamic_bundle`	Customer-selectable bundle with selection groups.	Yes. Selection groups must be created separately.
Customizable Product	Product with custom input fields or custom option fields.	No

Features

Grouped products: Create a product that includes multiple existing products as a set.

Product badges: Optionally assign a badge to highlight offers, new arrivals, or other product attributes.

Variants: Add variants inline during product creation or create them later using the Add Product Variants endpoint.

Custom fields: Add customer input fields or predefined customization options during product creation.

Donation and crowdfunding products: Create products with progress tracking using product-specific metadata.

Dynamic bundles: Create a bundle product first, then configure its selection groups using the Dynamic Bundle selection groups endpoint.

Important Notes

Categories cannot be added during product creation.
To assign a product to one or more categories, use the following endpoints after creation:

Add a product to a certain category

Bulk Add Product to Category

Dynamic Bundle products require at least one selection group before they can be published.

If you create a Dynamic Bundle product as a draft, you can add selection groups later before publishing it.

Some product classes restrict specific fields such as sale_price, quantity, is_infinite, or requires_shipping.

🔑Scopes

products.read_write - Products Read & Write

Dynamic Bundle flow

Dynamic Bundle products require two API requests:

Create the Dynamic Bundle product using POST /v1/products/

Add selection groups using PATCH /v1/products/{product_id}/selection-groups/bulk-patch/

If the product is created as a draft, use this flow:

Create the product as draft using POST /v1/products/

Add selection groups using PATCH /v1/products/{product_id}/selection-groups/bulk-patch/

Publish the product using PATCH /v1/products/{product_id}/

The Dynamic Bundle selection groups endpoint is currently not published.

application/json

Bodyapplication/json

{
    "id": "product-uuid",
    "name": {
        "ar": "حزمة البناء المخصصة",
        "en": "Custom Build Bundle"
    },
    "product_class": "dynamic_bundle",
    "sku": "BUNDLE-001",
    "price": 0,
    "is_draft": false,
    "is_published": false,
    "requires_shipping": true,
    "meta": {
        "location_id": "dd125776-70d1-4819-934c-a29b8ebd18ca"
    },
    "selection_groups": []
}

Supported product classes

Features

Important Notes

Dynamic Bundle flow

Request

Request Code Samples

Responses

Create Product

Supported product classes#

Features#

Important Notes#

Dynamic Bundle flow#

Request

Request Code Samples

Responses

Supported product classes

Features

Important Notes

Dynamic Bundle flow