Sign in
latestOpenAPI 3.0.0Proprietary2026-08-22131410675.6 KB

8d8a7cf79204

webhooks

Create a webhook

Create a webhook for specific events in the environment.

post/v1/environment/webhooks

Request body

event'batch' | 'carrier_connected' | 'order_source_refresh_complete' | 'rate' | 'report_complete' | 'sales_orders_imported' | 'track' required

The possible webhook event values

urlstring url required

A URL

namestring

The name of the webhook

store_idinteger

Store ID

Example request

{
  "url": "https://example.com/resource",
  "headers": [
    {
      "key": "custom-key",
      "value": "custom-value"
    }
  ],
  "name": "My New Webhook",
  "store_id": 123456
}

Response

The request was a success.

webhook_idstring

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

urlstring url

A URL

event'batch' | 'carrier_connected' | 'order_source_refresh_complete' | 'rate' | 'report_complete' | 'sales_orders_imported' | 'track'

The possible webhook event values

namestring

The name of the webhook

store_idinteger

Store ID

Example response

{
  "webhook_id": "se-28529731",
  "url": "https://example.com/resource",
  "headers": [
    {
      "key": "custom-key",
      "value": "custom-value"
    }
  ],
  "name": "My Webhook",
  "store_id": 123456
}