Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Create Downloadable Product

POST

https://api.zid.sa/v1/products/

Here’s the updated description with the additional clarification:

The 'Create Downloadable Product' endpoint allows users to add a new digital product to their store. This endpoint enables specifying product details, such as name, price, SKU, and download settings, to configure the product for digital delivery without shipping requirements. The process is the same as creating any other product, with the key distinction being the inclusion of 'product_class': 'downloadable' in the request payload. The response includes product metadata, availability, and stock settings relevant to digital products.

🔑Scopes

products.read_write - Products Read & Write

Request

Header Params

Body Params application/json

Example

{
    "name": {
        "ar": "منتج قابل للتنزيل",
        "en": "downloadable product"
    },
    "price": 2,
    "is_draft": true,
    "product_class": "downloadable"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products/' \
--header 'Store-Id: 3' \
--header 'Accept-Language: ar' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Currency: SAR' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Role: Manager' \
--header 'Authorization: {{Autherization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": {
        "ar": "منتج قابل للتنزيل",
        "en": "downloadable product"
    },
    "price": 2,
    "is_draft": true,
    "product_class": "downloadable"
}'

Responses

🟢201Success

application/json

Body

Example

{
    "id": "3471cfc4-08fe-4354-aa64-ac3786e86e83",
    "product_class": "downloadable",
    "sku": "Z.17703616723256807",
    "barcode": "",
    "parent_id": null,
    "name": {
        "ar": "منتج قابل للتنزيل",
        "en": "downloadable product"
    },
    "slug": "منتج-قابل-للتنزيل",
    "price": 2,
    "short_description": {
        "ar": "",
        "en": ""
    },
    "sale_price": null,
    "formatted_price": "2.00  ر.س ",
    "formatted_sale_price": null,
    "currency": "SAR",
    "currency_symbol": " ر.س ",
    "attributes": [],
    "categories": [],
    "display_order": 32766,
    "has_options": false,
    "has_fields": false,
    "images": [],
    "videos": [],
    "is_draft": true,
    "quantity": null,
    "is_infinite": true,
    "html_url": "https://osama.zid.store/products/منتج-قابل-للتنزيل",
    "weight": {
        "value": null,
        "unit": "kg"
    },
    "keywords": [],
    "requires_shipping": false,
    "is_taxable": true,
    "structure": "standalone",
    "seo": null,
    "rating": {
        "average": 0,
        "total_count": 0
    },
    "store_id": 3,
    "purchase_restrictions": {
        "min_quantity_per_cart": null,
        "max_quantity_per_cart": null,
        "availability_period_start": null,
        "availability_period_end": null,
        "sale_price_period_start": null,
        "sale_price_period_end": null
    },
    "meta": {
        "download_limit": null,
        "expiration_period": null
    },
    "created_at": "2026-02-06T07:07:52.390033Z",
    "updated_at": "2026-02-06T07:07:52.390059Z"
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-02-06 07:23:41

Digital Products

Generate Upload URL