Webhooks
Webhooks are configured within the App (no code required) and send HTTP requests to an external service when a specific event is triggered.
The Webhook Object
id integer
Primary key of the webhook.
name string
Name for the webhook. Shown in the Admin App.
method string
HTTP method to use. One of GET, POST.
url string
Where to send the request too.
status string
Status of the webhook. One of active, inactive.
data boolean
Whether or not to send the event data to the external endpoint.
actions csv
When to fire the webhook. Can contain create, update, delete.
collections csv
What collections to fire this webhook on.
{
"data": {
"id": 1,
"name": "Build Website",
"method": "POST",
"url": "https://example.com/",
"status": "active",
"data": true,
"actions": ["create", "update"],
"collections": ["articles"]
}
}{
"data": {
"id": 1,
"name": "Build Website",
"method": "POST",
"url": "https://example.com/",
"status": "active",
"data": true,
"actions": ["create", "update"],
"collections": ["articles"]
}
}List Webhooks
List all webhooks that exist in CaseFusion.
Request
Query Parameters
Supports all global query parameters.
Response
An array of up to limit webhook objects. If no items are available, data will be an empty array.
Example
Retrieve a Webhook
List an existing webhook by primary key.
Request
Query Parameters
Supports all global query parameters.
Returns
Returns the requested webhook object.
Examples
Create a Webhook
Create a new webhook.
Request
Query Parameters
Supports all global query parameters.
Request Body
A partial webhook object.
name, actions, collections, and url are required.
Response
Returns the webhook object for the created webhook.
Example
Create Multiple Webhook
Create multiple new webhooks.
Request
Query Parameters
Supports all global query parameters.
Request Body
An array of partial webhook object.
name, actions, collections, and url are required.
Response
Returns the webhook objects for the created webhooks.
Example
Update a Webhook
Update an existing webhook.
Request
Query Parameters
Supports all global query parameters.
Request Body
A partial webhook object.
Response
Returns the webhook object for the updated webhook.
Example
Update Multiple Webhooks
Update multiple existing webhooks.
Request
Query Parameters
Supports all global query parameters.
Request Body
keys Required
Array of primary keys of the webhooks you'd like to update.
data Required
Any of the webhook object's properties.
Response
Returns the webhook objects for the updated webhooks.
REST API
Example
Delete a Webhook
Delete an existing webhook.
Request
Response
Empty body.
Example
Delete Multiple Webhooks
Delete multiple existing webhooks.
Request
Request Body
An array of webhook primary keys
Response
Empty body.