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. The event type that is passed in will determine what type of webhooks will be sent.

Webhooks can be viewed & edited via the ShipStation Application under Integrations in the Account Settings.

NOTE: Webhooks will be sent to the URL specified in the target_url. The HTTP request will be sent via POST and will contain a webhook JSON object in the body.

The body of this request to subscribe has the following attributes:

Name Data Type Description
target_url string, required The URL to send the webhooks to
event string, required The type of webhook to subscribe to. Must contain one of the following values: ORDER_NOTIFY, ITEM_ORDER_NOTIFY, SHIP_NOTIFY, ITEM_SHIP_NOTIFY
store_id int, optional If passed in, the webhooks will only be triggered for this store_id
friendly_name string, optional Display name for the webhook

Example Request

POST /webhooks/subscribe HTTP/1.1
Host: ssapi.shipstation.com
Authorization: __YOUR_AUTH_HERE__
Content-Type: application/json

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

Example Response

{
  "id": 123456
}