Webhooks
Webhook management endpoints
Webhooks
Register webhook URLs to receive notifications when content changes.
GET
/v1/webhooks/{tenant_id}List Webhooks
Retrieve all registered webhooks for your tenant.
Requires API Key
Path Parameters
| Name | Type | Description |
|---|---|---|
tenant_id | string | Your tenant ID. |
curl -X GET "https://api.knitt.co/v1/webhooks/ten_abc123" \ -H "Authorization: Bearer YOUR_API_KEY"
Response
Returns a list of webhooks.
{
"data": [
{
"id": "wh_abc123",
"url": "https://example.com/webhooks/knitt",
"events": [
"entry.created",
"entry.updated",
"entry.deleted"
],
"active": true,
"created_at": "2026-01-12T10:00:00Z"
}
]
}POST
/v1/webhooks/{tenant_id}Create Webhook
Register a new webhook endpoint to receive event notifications.
Requires API Key
Available events: entry.created, entry.updated, entry.deleted, entry.published, media.uploaded, media.deleted, form.submitted
Path Parameters
| Name | Type | Description |
|---|---|---|
tenant_id | string | Your tenant ID. |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | The HTTPS URL to send webhook payloads to. |
events | array | Yes | Array of event types to listen for. |
secret | string | No | A secret string used to sign webhook payloads for verification. |
curl -X POST "https://api.knitt.co/v1/webhooks/ten_abc123" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/webhooks/knitt",
"events": [
"entry.created",
"entry.updated",
"entry.deleted"
],
"secret": "whsec_your_secret_here"
}'Response
Returns the created webhook.
{
"data": {
"id": "wh_abc123",
"url": "https://example.com/webhooks/knitt",
"events": [
"entry.created",
"entry.updated",
"entry.deleted"
],
"active": true,
"created_at": "2026-01-12T10:00:00Z"
}
}DELETE
/v1/webhooks/{tenant_id}/{webhook_id}Delete Webhook
Remove a registered webhook.
Requires API Key
Path Parameters
| Name | Type | Description |
|---|---|---|
tenant_id | string | Your tenant ID. |
webhook_id | string | The ID of the webhook. |
curl -X DELETE "https://api.knitt.co/v1/webhooks/ten_abc123/wh_abc123" \ -H "Authorization: Bearer YOUR_API_KEY"
Response
Returns a confirmation message.
{
"message": "Webhook deleted successfully."
}Last updated: February 7, 2026