curl -X PATCH https://api.tracklysms.com/api/v2/webhooks/66b0f7c84a1d4b2e9c3a1f2e \
-H "X-Api-Key: trk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"],
"active": true,
"signingSecretRotatedAt": "2026-06-15T12:00:00Z",
"createdAt": "2026-06-01T09:00:00Z",
"updatedAt": "2026-07-26T16:00:00Z"
}
Webhooks (v2)
Update Webhook Endpoint
Change a webhook endpoint’s URL, event subscription, or active state.
PATCH
/
v2
/
webhooks
/
{endpoint_id}
curl -X PATCH https://api.tracklysms.com/api/v2/webhooks/66b0f7c84a1d4b2e9c3a1f2e \
-H "X-Api-Key: trk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"],
"active": true,
"signingSecretRotatedAt": "2026-06-15T12:00:00Z",
"createdAt": "2026-06-01T09:00:00Z",
"updatedAt": "2026-07-26T16:00:00Z"
}
Updates a webhook endpoint. Send any subset of the fields below.
Path Parameters
string
required
The endpoint’s id.
Body Parameters
string
New HTTPS URL (max 2000 chars, public host).
array
New event subscription list (see supported events).
boolean
Enable or disable delivery to this endpoint.
Examples
curl -X PATCH https://api.tracklysms.com/api/v2/webhooks/66b0f7c84a1d4b2e9c3a1f2e \
-H "X-Api-Key: trk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out"],
"active": true,
"signingSecretRotatedAt": "2026-06-15T12:00:00Z",
"createdAt": "2026-06-01T09:00:00Z",
"updatedAt": "2026-07-26T16:00:00Z"
}
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | validation_failed | The URL or events list is invalid. |
| 404 | not_found | No endpoint with that id on the account. |