Defines the URL to which Check will send webhook requests for events that pertain to your organization.
A webhook config tells Check where to send webhooks and which events to send. Use the event_types attribute to choose event types when creating or updating a config through the API; call List event types to see which values are selectable at your API version. A new webhook config defaults to an empty event_types list, so Check won't send it any webhooks until you add types. Set event_types to null to receive every event type. See Managing webhook configs and deliveries for details.
Each webhook config also has a key, which we use to create a signature that you can recreate on the receiving side to verify the authenticity of our requests.
{
"id": "whc_7uCODm8JFmZyov9jL8QO",
"url": "http://3385edbc219e.ngrok.io",
"key": "2bfce877d2e64ea6a8dd45ffb2ce897eb4d97485",
"active": true,
"api_version": null,
"event_types": ["employee.created", "payroll.updated"]
}| Attribute | Description |
|---|---|
idstring | Unique identifier for the webhook config. |
urlstring | URL where webhook events will be sent. |
keystring | Key that Check will use to generate the X-Signature header in webhook requests. |
activeboolean | Indicates whether the config is active. If false, Check will not send webhook events to this URL. |
api_versionstring, nullable | API version used to serialize webhook event payloads for this config. Accepts any supported Check API version label (for example, 2025-01-01). When null, payloads follow your account's default API version. |
event_typesarray of strings, nullable | Event types this webhook config receives. An empty list receives none; null receives every event type. See List event types for selectable values. |

