kudosity-webhookslisted
Install: claude install-skill kudosity/skills
# Create & Manage Webhooks
Webhooks allow users to receive HTTP POST notifications when events occur, such as SMS delivery status changes, inbound messages, link clicks, and opt-outs.
## Authentication
- Header: `x-api-key: {KUDOSITY_API_KEY}`
- Credentials come from the Kudosity dashboard under **Developers → API Settings**
## API Details
- **Base URL**: `https://api.transmitmessage.com`
- **Content-Type**: `application/json`
- All requests use `curl` commands
## Create a Webhook
**Endpoint**: `POST /v2/webhook`
Required parameters:
- `name` (string): Webhook name, 2-100 characters
- `url` (string): HTTPS URL that accepts JSON-encoded POST requests
Optional parameters:
- `filter` (object): Filter which events trigger the webhook
- `event_type` (array): Types of events to subscribe to
- `sender` (array): Filter by sender number
- `status` (array): Filter by message status (for status events only)
- `message_ref` (array): Filter by message reference
- `campaign_id` (array): Filter by campaign ID
- `rate_limit` (integer): Max requests per second to your URL (max 10,000, 0 = system default)
### Available Event Types
Ten event types, covering every channel — not just SMS:
| Event Type | Description |
|-----------|-------------|
| `SMS_STATUS` | SMS delivery status changes |
| `SMS_INBOUND` | Inbound SMS received from a recipient |
| `MMS_STATUS` | MMS status changes (currently internal statuses only — SENT, FAILED) |
| `MMS_INBOUND` | Inbound MMS received fr