# Send events to your systems with webhooks

> A webhook tells your own system the moment something happens in your store, such as a new order or a stock change. Add an endpoint URL in Settings > Webhooks, choose the events, send a test, and see every delivery and its response.

Help Centre / Integrations - Updated 2 November 2026

A webhook sends a message to a web address you choose, the moment something happens in your store. For example, a new order can go straight to your fulfilment system, a stock change to your inventory sheet, or a new customer to your CRM. Your systems don't need to keep asking Shoprocket for changes.

You need somewhere for the messages to go: an address on your own server, or a tool that gives you one, such as an automation platform. Setting up the receiving end is usually a developer's job.

## Before you begin

- Webhooks are on the **Growth** plan and up. On a lower plan, the screen shows which plan includes them.
- They are part of the **Developer tools** app, with **API keys**. If you don't see **Webhooks** under **Settings** in your sidebar, go to **Apps**, find **Developer tools** under **Developers** and click **Add**. See [Add and remove apps](https://shoprocket.io/help/the-apps-page.md).

## Add an endpoint

1. In your dashboard, go to **Settings > Webhooks** and click **Add endpoint**.
2. Enter a **Name**. Name it after the system it sends to, so you know what breaks if you remove it.
3. Enter the **Endpoint URL**. It must start with `https://`.
4. Leave **Test mode endpoint** off for the endpoint that runs your real business. Switch it on for an endpoint that should receive test orders only.
5. Choose the events to send. Tick events one by one, use **Select all** for a group, or **Subscribe to all events**. It is best to choose only the events your system uses. Click **Example** beside an event to see the message it sends.
6. Click **Add endpoint**.

![The Add webhook endpoint drawer: the name Fulfilment, an https endpoint URL, Test mode endpoint off, and order.created ticked with its example payload open](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## The events

| Group | Events |
|---|---|
| **Orders** | Created, updated, paid, refunded, fulfilled, partially fulfilled, deleted |
| **Customers** | Created, updated, deleted |
| **Products** | Created, updated, deleted |
| **Inventory** | Stock updated |
| **Discounts** | Created, updated, deleted |
| **Categories** | Created, updated, deleted |
| **Subscriptions** | Created, renewed, renewal failed, paused, resumed, cancelled, expired |
| **Licence keys** | Assigned, suspended, reinstated, expired, revoked |

## Send a test

Click **Send test** on an endpoint. Shoprocket sends a test event straight away and tells you whether your endpoint accepted it and what your server answered, for example "Responded 200 in 140ms.", or that it couldn't be reached at all.

## See what was sent

The **Recent deliveries** card, under your endpoints, lists every event Shoprocket tried to send: when, the response code your server gave, and how many attempts it took. A delivery is **Delivered**, **Queued**, **Retrying** or **Failed**. Once you have fixed a problem on your side, click **Re-send** on any delivery to send it again.

![An endpoint's Recent deliveries: delivered events with HTTP 200, one Retrying with HTTP 500, and the Re-send button](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## When deliveries fail

Your server should answer each message with any 2xx response code. If it doesn't, Shoprocket keeps trying for about a day.

If deliveries to one endpoint fail 20 times in a row, the endpoint is switched off and says why. Fix your endpoint, then click **Re-enable now**. Anything queued while it was off is then sent. Before an endpoint is switched off, it warns you as failures build up, for example "3 deliveries have failed in a row. After 20 we switch this endpoint off automatically."

## Edit or delete an endpoint

Click an endpoint's edit button to change its name, address or events, then **Save**. To stop sending to it for good, click **Delete** and confirm.

## For developers

Every message is signed with the endpoint's signing secret, so your server can check it really came from Shoprocket. Click **Show signing secret** on the endpoint to copy it. Each message also includes its event name and a delivery ID, so your server can ignore repeats. The developer guide has the signature check, every event's payload and retry details. See [Webhooks](https://shoprocket.io/docs/webhooks.md).

## Related

- [Create an API key](https://shoprocket.io/help/api-keys.md)
- [Zapier](https://shoprocket.io/help/zapier.md)
- [Test mode vs live](https://shoprocket.io/help/test-mode-vs-live.md)

[Open Webhooks in your dashboard](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/help/webhooks
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
