1. Events
Tjar
  • 🗂️ Overview
  • 🚀 Start Here
  • Orders
    • List Orders
    • Get Order Details
    • Order Statuses
    • Create Order
    • Change Order Status
  • Products
    • Digital
      • Create Digital Product
      • Get Digital Product Details
      • Update Digital Product
    • Booking
      • Get Booking Product Details
      • Create Booking Product
      • Update Booking Product
    • Service
      • Get Service Product
      • Create Service Product
      • Update Service Product
    • Physical
      • Get Physical Product Details
      • Create Physical Product
      • Update Physical Product
    • List All Products
    • Get Product Details
    • Delete Product
  • Media
    • Upload Media
    • Upload Multiple Media
    • Update Media
  • Webhook
    • Events
      • Cart Abandoned
      • Order Created
      • Order Created
      • Order Status Changed
      • Order Updated
      • Product Created
      • Product Deleted
      • Product Updated
      • Product Review Submitted
      • Product Stock Update
      • Customer Created
      • Customer Updated
      • Customer Login
      • Customer Welcome
      • Category Created
      • Category Updated
      • Category Deleted
      • Brand Created
      • Brand Updated
      • Brand Deleted
    • List Webhooks
      GET
    • Register Webhook
      POST
    • Update Webhook
      PUT
    • Delete Webhook
      DELETE
    • Verify Signature
      POST
    • Refresh Secret
      POST
    • Webhook Events
      GET
  • Abandoned Cart
    • List Abandoned Carts
    • Get Abandoned Cart Details
    • Send Reminder
  1. Events

Product Created

Product Created Webhook#

Triggered when a new product is created in the store.

Event Name#

product.created

Payload Examples by Product Type#

Physical Product Example#

{
  "event": "product.created",
  "created_at": "2026-06-13T09:30:15+03:00",
  "data": {
    "product": {
      "id": 227,
      "identifier": 227,
      "name": {
        "ar": "قميص قطني",
        "en": "Cotton Shirt"
      },
      "type": "Simple",
      "type_id": 1,
      "price": 89.99,
      "sale_price": 59.99,
      "stock": 50,
      "is_published": true,
      "created_at": "2026-06-13 09:30:15",
      "updated_at": "2026-06-13 09:30:15"
    }
  }
}

Booking Product Example#

{
  "event": "product.created",
  "created_at": "2026-06-13T10:00:00+03:00",
  "data": {
    "product": {
      "id": 228,
      "identifier": 228,
      "name": {
        "ar": "حجز ملعب كرة قدم",
        "en": "Football Field Booking"
      },
      "type": "Booking",
      "type_id": 3,
      "price": 150.00,
      "sale_price": 120.00,
      "stock": null,
      "is_published": true,
      "created_at": "2026-06-13 10:00:00",
      "updated_at": "2026-06-13 10:00:00",

      "booking_meta_data": {
        "duration": {
          "hours": 2,
          "minutes": 0
        },
        "min_customers": 1,
        "max_customers": 22,
        "is_required": true,
        "is_enable_date_range": true,
        "is_enable_booking_same_date": false,
        "availability": {
          "monday": {
            "enabled": true,
            "working_hours": {
              "start": "08:00",
              "end": "22:00"
            },
            "breaks": []
          },
          "tuesday": {
            "enabled": true,
            "working_hours": {
              "start": "08:00",
              "end": "22:00"
            },
            "breaks": [
              {
                "start": "12:00",
                "end": "14:00"
              }
            ]
          }
        }
      }
    }
  }
}

Service Product Example#

{
  "event": "product.created",
  "created_at": "2026-06-13T11:00:00+03:00",
  "data": {
    "product": {
      "id": 229,
      "identifier": 229,
      "name": {
        "ar": "خدمة استشارة",
        "en": "Consultation Service"
      },
      "type": "Service",
      "type_id": 2,
      "price": 200.00,
      "sale_price": 150.00,
      "stock": null,
      "is_published": true,
      "created_at": "2026-06-13 11:00:00",
      "updated_at": "2026-06-13 11:00:00",

      "service_meta_data": {
        "id": 45,
        "preview_link": "https://example.com/service-preview",
        "release_date": "2026-06-15",
        "update_date": "2026-06-13"
      }
    }
  }
}

Digital Product Example#

{
  "event": "product.created",
  "created_at": "2026-06-13T12:00:00+03:00",
  "data": {
    "product": {
      "id": 230,
      "identifier": 230,
      "name": {
        "ar": "بطاقة هدايا",
        "en": "Gift Card"
      },
      "type": "Digital",
      "type_id": 4,
      "price": 100.00,
      "sale_price": 90.00,
      "stock": 500,
      "is_published": true,
      "created_at": "2026-06-13 12:00:00",
      "updated_at": "2026-06-13 12:00:00",

      "digital_meta_data": {
        "id": 78,
        "product_id": 230,
        "type": "digital_cards",
        "preview_link": "https://example.com/card-preview",
        "file": "gift_cards.json",
        "contains_download_link": false,
        "external_download_link": null,
        "release_date": "2026-06-13",
        "update_date": "2026-06-13",
        "additional_information": "Digital gift cards for various retailers",
        "metadata": {
          "digital_type": "digital_cards",
          "entry_code_method": "automatic",
          "cards": [
            "GIFT123456789",
            "GIFT987654321",
            "GIFT456789123"
          ],
          "card_count": 3
        }
      }
    }
  }
}

Payload Example#

{
  "event": "product.created",
  "created_at": "2026-06-13T09:30:15+03:00",
  "data": {
    "product": {
      "id": 227,
      "identifier": 227,
      "name": {
        "ar": "قميص قطني",
        "en": "Cotton Shirt"
      },
      "summary": {
        "ar": "قميص قطني مريح للصيف",
        "en": "Comfortable cotton shirt for summer"
      },
      "description": {
        "ar": "قميص قطني عالي الجودة مناسب للصيف",
        "en": "High quality cotton shirt suitable for summer"
      },
      "type": "Simple",
      "type_id": 1,
      "price": 89.99,
      "sale_price": 59.99,
      "is_refundable": true,
      "min_purchase": 1,
      "max_purchase": 5,
      "image": "https://example.com/storage/products/shirt.jpg",
      "is_published": true,
      "stock": 50,
      "is_unlimited": false,
      "ratings": 4.5,
      "reviews_count": 12,
      "created_at": "2026-06-13 09:30:15",
      "updated_at": "2026-06-13 09:30:15",

      "product_options": [
        {
          "type": "color",
          "title": "Color",
          "sub_title": "Choose your preferred color",
          "options": ["Red", "Blue", "Green"],
          "is_required": true,
          "multi_select": false
        }
      ],

      "brand": {
        "id": 5,
        "name": {
          "ar": "علامة تجارية",
          "en": "Brand Name"
        },
        "logo": "https://example.com/storage/brands/logo.jpg"
      },

      "tags": [
        {
          "id": 1,
          "name": {
            "ar": "ملابس",
            "en": "Clothing"
          }
        }
      ],

      "categories": [
        {
          "id": 10,
          "name": {
            "ar": "رجالي",
            "en": "Men"
          }
        }
      ],

      "sub_categories": [
        {
          "id": 15,
          "name": {
            "ar": "قمصان",
            "en": "Shirts"
          }
        }
      ],

      "inventory": {
        "stock_count": 50,
        "sku": "SHIRT-001"
      },

      "delivery_options": [
        {
          "id": 1,
          "title": {
            "ar": "توصيل قياسي",
            "en": "Standard Delivery"
          },
          "price": 10.00,
          "estimated_days": 3
        }
      ],

      "return_policy": {
        "id": 1,
        "days": 30,
        "description": {
          "ar": "سياسة الإرجاع خلال 30 يوم",
          "en": "30-day return policy"
        }
      },

      "gallery": [
        {
          "id": 101,
          "image": "https://example.com/storage/products/shirt-1.jpg",
          "is_primary": false
        },
        {
          "id": 102,
          "image": "https://example.com/storage/products/shirt-2.jpg",
          "is_primary": true
        }
      ],

      "meta_data": {
        "meta_title": {
          "ar": "قميص قطني ممتاز",
          "en": "Premium Cotton Shirt"
        },
        "meta_description": {
          "ar": "قميص قطني عالي الجودة",
          "en": "High quality cotton shirt"
        },
        "keywords": "cotton,shirt,summer"
      }
    }
  }
}

Payload Schema#

Root Object#

FieldTypeDescription
eventstringWebhook event name
created_atdatetimeEvent creation timestamp
dataobjectEvent payload

Product Object#

FieldTypeDescription
idintegerInternal product ID
identifierintegerProduct identifier
nameobjectProduct name (ar, en)
summaryobjectProduct summary (ar, en)
descriptionobjectProduct description (ar, en)
typestringProduct type
type_idintegerProduct type ID
pricedecimalRegular price
sale_pricedecimalSale price
is_refundablebooleanWhether refundable
min_purchaseintegerMinimum purchase quantity
max_purchaseintegerMaximum purchase quantity
imagestringMain product image URL
is_publishedbooleanPublication status
stockintegerAvailable stock quantity
is_unlimitedbooleanUnlimited stock flag
ratingsdecimalAverage rating
reviews_countintegerNumber of reviews
created_atdatetimeProduct creation date
updated_atdatetimeLast update date
product_optionsarrayProduct options/variants
brandobjectBrand information
tagsarrayProduct tags
categoriesarrayProduct categories
sub_categoriesarraySub categories
inventoryobjectInventory details
delivery_optionsarrayDelivery options
return_policyobjectReturn policy details
galleryarrayProduct gallery images
meta_dataobjectSEO metadata
booking_meta_dataobjectBooking product metadata
service_meta_dataobjectService product metadata
digital_meta_dataobjectDigital product metadata

Product Types#

This webhook supports all product types in the system. The payload structure varies based on the product type:

Physical Products#

Standard products with inventory and shipping. No special metadata fields.

Booking Products#

Products that require booking/scheduling (e.g., appointments, rentals). Includes booking_meta_data field with:
duration: Booking duration components
min_customers: Minimum customers required
max_customers: Maximum customers allowed
availability: Weekly availability schedule
is_required: Whether booking is required
is_enable_date_range: Date range booking enabled
is_enable_booking_same_date: Same day booking enabled

Service Products#

Service-based products (e.g., consultations, subscriptions). Includes service_meta_data field with:
preview_link: Preview/download link
release_date: Service availability date
update_date: Last update date

Digital Products#

Digital goods like cards, vouchers, or downloadable files. Includes digital_meta_data field with:
type: Digital product type
file: File information
contains_download_link: External download link flag
external_download_link: External download URL
release_date: Release date
update_date: Last update date
metadata: Additional metadata including digital cards info

Brand Object#

FieldType
idint
nameobject
logostring

Inventory Object#

FieldType
stock_countinteger
skustring

Gallery Item Object#

FieldType
idinteger
imagestring
is_primaryboolean

Meta Data Object#

FieldType
meta_titleobject
meta_descriptionobject
keywordsstring

Booking Meta Data Object#

FieldType
durationobject
min_customersinteger
max_customersinteger
availabilityobject
is_requiredboolean
is_enable_date_rangeboolean
is_enable_booking_same_dateboolean

Service Meta Data Object#

FieldType
idinteger
preview_linkstring
release_datedate
update_datedate

Digital Meta Data Object#

FieldType
idinteger
product_idinteger
typestring
preview_linkstring
filestring
contains_download_linkboolean
external_download_linkstring
release_datedate
update_datedate
additional_informationstring
metadataobject

Response#

Your endpoint should return:
Modified at 2026-06-13 13:29:38
Previous
Order Updated
Next
Product Deleted
Built with