v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
Ecommerce: Products

Create digital product

Create a published digital product with a single variant and an optional external download link.

post/api/ecommerce/v1/stores/{store_id}/products/digital

Path parameters

store_idstring required
Example:store_01J8Z5F8W9K8M4A7B3C2D1E0FG

The ID of the store to create the product in.

Request body

namestring required

The product name.

priceinteger required

Price in the smallest currency unit (e.g. cents). Must be positive.

descriptionstring nullable

The product description.

currencystring nullable

ISO 4217 currency code. Defaults to the store's default currency when omitted.

download_urlstring nullable

Optional external download link delivered to the customer after purchase.

Example request

{
  "name": "My eBook",
  "price": 999,
  "description": "A digital download.",
  "currency": "usd",
  "download_url": "https://example.com/downloads/ebook.pdf"
}

Response

Created response

admin_urlstring

Admin UI deep-link to manage the product.

Example response

{
  "product": {
    "id": "prod_01J8Z5F8W9K8M4A7B3C2D1E0FG",
    "title": "My Product",
    "type": "physical",
    "status": "published",
    "price": 1000,
    "currency_code": "usd"
  },
  "admin_url": "https://admin.example.com/store_01.../products/edit?product=prod_01..."
}