Shipment Status Push

Delivery order status push

This is the cus payload format (HookCus.format_type = "cus", the default). A subscription created with a different format_type receives a different, much larger payload — ask Omisell before assuming this shape.
Delivery: POST with Content-Type: application/json and Authorization: <client secret> (the raw secret, no scheme prefix). request_id is generated per delivery attempt. Redirects are not followed — answer 2xx directly. Retries: up to 5, exponential backoff starting at 5 minutes.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Your endpoint answers 2xx

application/json

Your endpoint must return exactly 200. deliver_hook_cus treats every other code — including 201, 202 and 204 — as a FAILURE and retries it (5 attempts: 5 / 10 / 20 / 40 / 80 minutes). Note that the hook health monitor counts any 2xx as a success, so an endpoint returning 204 is retried and still reported as healthy. Redirects are not followed — a 3xx is recorded as a response, not followed.

Bodyapplication/json

curl --location 'https://api.omisell.com/webhook-url' \ --header 'Seller-ID;' \ --header 'Country;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "data": { "order_number": "526960291614111", "omisell_order_number": "ODVN26072346D433C5", "omisell_shipment_number": "SPVN2607235E5377A7", "wms_order_number": "", "courier_tracking_number": "526960291614111", "created_time": 1784774694.0, "updated_time": 1784774754.0, "status_id": 300, "status_name": "Shipped", "is_fulfilled": true }, "shop_id": 11305, "seller_id": 27001999, "platform": "retail", "event": "shipment.shipped", "timestamp": 1788315800, "request_id": "68b6f1c4a90c3e7f2d41b9e6" }'

Request

Responses