Sign in
latestOpenAPI 3.1.0MIT2026-08-104712182.1 KB

c71c20d26559

webhooks

Subscribe to webhook

Subscribes to a specific type of webhook. If a store_id is passed in, the webhooks will only be triggered for that specific store_id.

Note: Webhooks can only be modified through the ShipStation UI under Account Settings.

post/webhooks/subscribe

Request body

target_urlstring required

The URL to send the webhooks to

event'ORDER_NOTIFY' | 'ITEM_ORDER_NOTIFY' | 'SHIP_NOTIFY' | 'ITEM_SHIP_NOTIFY' | 'FULFILLMENT_SHIPPED' | 'FULFILLMENT_REJECTED' required

The type of webhook to subscribe to

store_idinteger nullable

Store ID (optional - webhooks will only trigger for this store)

friendly_namestring

Display name for the webhook

Example request

{
  "target_url": "http://someexamplewebhookurl.com/neworder",
  "event": "ORDER_NOTIFY",
  "store_id": 12345,
  "friendly_name": "My Webhook"
}

Response

Webhook subscription created successfully

WebHookIDinteger
HookTypestring
Urlstring
Namestring

Example response

{
  "WebHookID": 123456
}