Full reference for all configurable options on a webhook endpoint.
Basic Settings #
| Field | Type | Description |
|---|---|---|
| Name | Text | Human-readable label. Not sent in payloads. |
| URL | URL | Target URL for POST requests. HTTPS strongly recommended. |
| Status | Enum | active, inactive, or disabled (see below) |
Delivery Settings #
| Field | Type | Default | Description |
|---|---|---|---|
| Timeout | Integer | 30 | HTTP timeout in seconds. Requests exceeding this are treated as failures. |
| Max Retries | Integer | 5 | Maximum retry attempts after initial failure. Range: 0–5. |
| Custom Headers | JSON | None | JSON object of header name/value pairs added to every delivery. |
Custom Headers Format #
Enter as a JSON object:
{
"Authorization": "Bearer your_internal_token",
"X-Source": "dmsi-webhooks"
}
Behavior Settings #
| Field | Type | Default | Description |
|---|---|---|---|
| Auto-Subscribe | Boolean | Off | When enabled, the endpoint is automatically subscribed to any new event type registered in the future. |
| Debug Mode | Boolean | Off | When enabled, extra diagnostic data is written to the delivery log. Debug log entries are automatically deleted after 24 hours. |
Endpoint Status Values #
| Status | Description |
|---|---|
active | Endpoint receives all deliveries for subscribed events |
inactive | Deliveries are paused for this endpoint (manually set) |
disabled | Endpoint was automatically disabled after receiving a 410 Gone response. Requires manual reactivation or deletion. |
Security Fields #
| Field | Description |
|---|---|
| Signing Secret | HMAC-SHA256 signing key. Shown once on creation. Masked as *{last4} on all subsequent views. |
| Secret Key | Optional additional key field for custom integrations. Also encrypted at rest. |
Timestamps #
| Field | Description |
|---|---|
| Created At | When the endpoint was first created |
| Updated At | Last modification time |
| Last Delivery At | Timestamp of the most recent successful delivery |
Related Topics #
- Creating an Endpoint
- Event Subscriptions
- Signing Secret Rotation
