---
title: "Subscribe to 10DLC events"
method: POST
path: "/v3/10dlc/subscriptions"
tags: ["10DLC"]
---

# Subscribe to 10DLC events

`POST /v3/10dlc/subscriptions`

Registers a callback URL to receive Wavix 10DLC event notifications.

## Request body

- TenDLCEventSubscription — Represents a subscription that delivers 10DLC lifecycle events to a webhook URL.
  - `subscription_category` string, required — Category of 10DLC events to subscribe to. One of `brand` (brand status changes), `campaign` (campaign status changes), or `number` (number provisioning changes).
  - `url` string, required — Webhook URL that events in this category are delivered to.

## Response `201`

Returns the created 10DLC event subscription.

- object — Represents a subscription that delivers 10DLC lifecycle events to a webhook URL.
  - `subscription_category` string, required — Category of 10DLC events to subscribe to. One of `brand` (brand status changes), `campaign` (campaign status changes), or `number` (number provisioning changes).
  - `url` string, required — Webhook URL that events in this category are delivered to.

## Other responses

- `403` — Returns when the 10DLC feature is disabled for the account.

## Changes

- **2026-06-15** `76b9bb35619f` — 2 info
  - added `#/components/schemas/TenDLCEventSubscription` to the response body `allOf` list for the response status `201`
  - removed `#/components/schemas/TenDlcEventSubscription` from the response body `allOf` list for the response status `201`
- **2026-05-25** `33be77905120` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1` — 3 info
  - api operation id `SubscribetoWavix10DLCevents` removed and replaced with `ten_dlc_subscriptions_create`
  - added `#/components/schemas/TenDlcEventSubscription` to the response body `allOf` list for the response status `201`
  - removed `#/components/schemas/10DLCeventssubscription` from the response body `allOf` list for the response status `201`
- **2026-02-12** `fabaadf195a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v3/10dlc/subscriptions/post.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)