# Fulfillments update

> Triggered when logistics information is updated. Reference for the Shoplazza fulfillments/update webhook: request headers and payload fields.

**Webhook** fulfillments/update

Triggered when logistics information is updated.

Requires the `order` [access scope](/docs/app/building-blocks/authentication/access-scopes). Minimum supported version: `202007`.

## Request headers

- `X-Shoplazza-Topic` string

  The event that triggered this delivery, e.g. orders/create

  **Example:** `orders/create`
- `X-Shoplazza-Hmac-Sha256` string

  Base64-encoded HMAC-SHA256 signature of the request body, generated with your app's Client Secret. Use it to verify the request comes from Shoplazza
- `X-Shoplazza-Shop-Domain` string

  The domain of the store that generated the event

  **Example:** `example.myshoplaza.com`
- `X-Shoplazza-Api-Version` string

  The API version used to serialize the payload

  **Example:** `2025-06`
- `X-Shoplazza-Deduplication-ID` string

  Deduplication ID for this delivery. It stays the same across retries of the same event—use it for idempotency

## Request body

**Schema | Example**

- `fulfillment` object

  - `id` string

    Fulfillment ID
  - `order_id` string

    Order ID
  - `status` string

    Fulfillment record status
  - `created_at` string

    Creation time (i.e. shipment time)
  - `updated_at` string

    Last update time
  - `tracking_company` string

    Logistics company name. See `tracking_items` for multiple tracking numbers
  - `tracking_company_code` string

    Logistics company code. See `tracking_items` for multiple tracking numbers
  - `tracking_number` string

    Tracking number. See `tracking_items` for multiple tracking numbers
  - `tracking_url` string

    Tracking URL. See `tracking_items` for multiple tracking numbers
  - `tracking_items` object[]

    List of tracking items, supporting multiple tracking numbers

    *   Array [

    - `tracking_company` string

      Logistics company name
    - `tracking_company_code` string

      Logistics company code
    - `tracking_number` string

      Tracking number
    - `tracking_url` string

      Tracking URL
    *   ]
  - `line_items` object[]

    Products shipped in this fulfillment

    *   Array [

    - `id` string

      Line item ID
    - `product_id` string

      Product ID
    - `product_title` string

      Product title
    - `product_handle` string

      Product handle
    - `product_url` string

      Product URL
    - `variant_id` string

      Variant ID
    - `variant_title` string

      Variant title
    - `sku` string

      Variant SKU
    - `spu` string

      Product SPU
    - `quantity` integer

      Quantity purchased
    - `shipped_quantity` integer

      Quantity shipped in this fulfillment
    - `price` string

      Product unit price
    - `compare_at_price` string

      Product compare-at unit price
    - `total` string

      Line total (unit price x quantity)
    - `duty_price` string

      Total duty
    - `payment_discount_price` string

      Allocated payment discount amount
    - `discount_applications` string

      Discount details
    - `fulfillment_status` string

      Fulfillment status
    - `requires_shipping` boolean

      Whether the item requires shipping
    - `weight` string

      Product weight
    - `weight_unit` string

      Weight unit
    - `image` string

      Product image URL
    - `note` string

      Product note
    - `vendor` string

      Vendor
    - `custom_properties` object

      Custom properties of the product
    - `properties` object[]

      Variant option properties

      *   Array [

      - `name` string

        Option property name (e.g., Color)
      - `value` string

        Option property value (e.g., Red)
      *   ]
    - `main_currency_prices` object

      Amounts in the primary-market currency

      - `actual_rate` string

        Exchange rate of the primary-market currency against the order currency (e.g., 7.25 means 1 unit of the primary-market currency equals 7.25 units of the order currency)
      - `compare_at_price` string

        The compare-at (original) unit price converted to the primary-market currency
      - `price` string

        The unit selling price converted to the primary-market currency
      - `total` string

        The line total (unit price x quantity) converted to the primary-market currency
    - `refund_quantity` integer (deprecated)

      Quantity of the most recent refund request (refund events only). (Deprecated: do not use.)
    - `refund_total` string (deprecated)

      Cumulative refunded item amount (refund events only). (Deprecated: do not use.)
    *   ]

```json
{
  "fulfillment": {
    "id": "string",
    "order_id": "string",
    "status": "string",
    "created_at": "string",
    "updated_at": "string",
    "tracking_company": "string",
    "tracking_company_code": "string",
    "tracking_number": "string",
    "tracking_url": "string",
    "tracking_items": [
      {
        "tracking_company": "string",
        "tracking_company_code": "string",
        "tracking_number": "string",
        "tracking_url": "string"
      }
    ],
    "line_items": [
      {
        "id": "string",
        "product_id": "string",
        "product_title": "string",
        "product_handle": "string",
        "product_url": "string",
        "variant_id": "string",
        "variant_title": "string",
        "sku": "string",
        "spu": "string",
        "quantity": 0,
        "shipped_quantity": 0,
        "price": "string",
        "compare_at_price": "string",
        "total": "string",
        "duty_price": "string",
        "payment_discount_price": "string",
        "discount_applications": "string",
        "fulfillment_status": "string",
        "requires_shipping": true,
        "weight": "string",
        "weight_unit": "string",
        "image": "string",
        "note": "string",
        "vendor": "string",
        "custom_properties": {},
        "properties": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "main_currency_prices": {
          "actual_rate": "string",
          "compare_at_price": "string",
          "price": "string",
          "total": "string"
        }
      }
    ]
  }
}
```