Webhook

shipments.items.removed

​

Items were removed from a shipment when it was split. Requires read:shipments.

Headers

  • Unique ID of the event. Retries of a delivery send the same ID, so use it to deduplicate.

  • When this delivery attempt was sent, as a Unix timestamp in seconds. Each retry sends a new timestamp.

  • Space-separated signatures, each v1, followed by the base64 HMAC-SHA256 of {webhook-id}.{webhook-timestamp}.{body}, keyed with your webhook secret.

Body·ShipmentItemsRemovedWebhookBody

required
application/json
  • The event's data. Its shape depends on the topic.

    Properties: 2
  • The ID of the seller the event belongs to.

  • When the event happened, in ISO 8601. Stable across retries; the webhook-timestamp header is when each attempt was sent.

  • The webhook topic.

  • The payload version.

Responses

  • Acknowledge delivery. Any 2XX status counts.

  • Fail delivery. Non-2XX statuses and timeouts are retried.

Request Example for postshipments.items.removed
{
  "type": "shipments.items.removed",
  "timestamp": "2026-10-20T16:00:00.123Z",
  "data": {
    "shipment_id": "",
    "shipment_item_ids": [
      ""
    ]
  },
  "version": "v2",
  "seller_id": "1234567"
}
No Body