---
title: "Webhook subscriptions"
description: "Have touchSMS call your own URL when something happens on your account.\n\nYou can subscribe to four events: `message_received` (an inbound message), `message_dlr` (a\ndelivery receipt), `optout_created` (a new opt-out) and `message_received_3cx`. Each\nsubscription has a target URL, a request method and optional headers. The URL can't point at\none of our own domains.\n\nSee [Webhooks](/guides/webhooks/) for each event's payload and how to verify signatures.\n"
version: "v2"
---

> Documentation Index
> Fetch the complete documentation index at: https://dev.touchsms.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

Path: touchSMS API

Have touchSMS call your own URL when something happens on your account.

You can subscribe to four events: `message_received` (an inbound message), `message_dlr` (a
delivery receipt), `optout_created` (a new opt-out) and `message_received_3cx`. Each
subscription has a target URL, a request method and optional headers. The URL can't point at
one of our own domains.

See [Webhooks](/guides/webhooks/) for each event's payload and how to verify signatures.

## Operations

- [List webhook subscriptions](/api/webhook-subscriptions/list/)
- [Create a webhook subscription](/api/webhook-subscriptions/create/)
- [Get a webhook subscription](/api/webhook-subscriptions/get/)
- [Update a webhook subscription](/api/webhook-subscriptions/update/)
- [Delete a webhook subscription](/api/webhook-subscriptions/delete/)


Source: https://dev.touchsms.com.au/api/tags/webhook-subscriptions/index.md