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", "message.clicked"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out", "message.clicked"],
"active": true,
"effectiveActive": true,
"disabledReason": null,
"disabledAt": null,
"failureStartedAt": null,
"disableIncidentId": null,
"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", "message.clicked"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out", "message.clicked"],
"active": true,
"effectiveActive": true,
"disabledReason": null,
"disabledAt": null,
"failureStartedAt": null,
"disableIncidentId": null,
"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.
In the staged destination-recovery release, sending
{"active": true} explicitly re-enables an operationally disabled endpoint and clears its current failure window, disable reason, time, and incident reference. Retained delivery and incident history remains available. Changing only the URL or subscriptions does not perform this recovery action. Inspect delivery history and test the repaired destination before re-enabling; a dashboard test does not re-enable it automatically.
Path Parameters
Body Parameters
Replacement non-empty event subscription list (see supported events). Omit this field to keep existing subscriptions. Include
message.clicked explicitly to receive clicks.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", "message.clicked"], "active": true }'
{
"id": "66b0f7c84a1d4b2e9c3a1f2e",
"accountId": 1042,
"url": "https://hooks.bizinga.com/trackly",
"events": ["message.delivered", "message.failed", "message.reply", "contact.opted_out", "message.clicked"],
"active": true,
"effectiveActive": true,
"disabledReason": null,
"disabledAt": null,
"failureStartedAt": null,
"disableIncidentId": null,
"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. |