---
title: "Subscribe to webhook"
method: POST
path: "/webhooks/subscribe"
tags: ["webhooks"]
---

# Subscribe to webhook

`POST /webhooks/subscribe`

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.

## Request body

- object
  - `target_url` string, 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_id` integer, nullable — Store ID (optional - webhooks will only trigger for this store)
  - `friendly_name` string — Display name for the webhook

## Response `200`

Webhook subscription created successfully

- object
  - `WebHookID` integer
  - `HookType` string
  - `Url` string
  - `Name` string

## Other responses

- `400` — Bad Request - The request could not be understood or was missing required parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `500` — Internal Server Error - An error occurred on the server

---

[API](https://skmtc.net/shipstation/apis/shipstation-v1-api-legacy.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-v1-api-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-v1-api-legacy/revisions/c71c20d26559/schema)