Create webhook
Creates a new webhook for the workspace. The response includes the signing secret which is used for HMAC-SHA256 verification of webhook payloads. Important: The secret is only shown once upon creation and cannot be retrieved again.
Path Parameters
URL-safe workspace identifier.
Body
Request payload for creating a new workspace webhook.
Request payload for creating a new workspace webhook.
Detailed description of the webhook's purpose (max 500 characters).
500Human-readable name for the webhook (1-128 characters).
1 - 128List of event types this webhook should receive.
Defines the types of events that can trigger webhook delivery.
This enumeration corresponds to the WEBHOOK_EVENT PostgreSQL enum and is used
to configure which events a webhook should receive notifications for.
"file.created"The URL to send webhook payloads to.
2048Optional custom headers to include in webhook requests.
Initial status of the webhook (enabled or disabled).
"enabled"Response
Webhook creation response that includes the secret (visible only once).
The secret is used for HMAC-SHA256 signature verification of webhook payloads. It is only returned when the webhook is first created and cannot be retrieved again. Store it securely.
Webhook creation response that includes the secret (visible only once).
The secret is used for HMAC-SHA256 signature verification of webhook payloads. It is only returned when the webhook is first created and cannot be retrieved again. Store it securely.
Consecutive failed deliveries since the last success.
Timestamp when this webhook was first created.
Account that created this webhook.
Detailed description of the webhook's purpose.
Human-readable name for the webhook.
List of event types this webhook receives.
Defines the types of events that can trigger webhook delivery.
This enumeration corresponds to the WEBHOOK_EVENT PostgreSQL enum and is used
to configure which events a webhook should receive notifications for.
"file.created"Custom headers included in webhook requests.
Opaque identifier of the webhook.
^whk_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$HMAC-SHA256 signing secret for webhook verification.
Important: This is the only time the secret will be shown. Store it securely as it cannot be retrieved again.
Current status of the webhook.
"enabled"Timestamp when this webhook was last modified.
The URL to send webhook payloads to.
Handle of the workspace this webhook belongs to.
3 - 32^[a-z0-9]+(?:-[a-z0-9]+)*$Timestamp of the most recent failed delivery.
Timestamp of the most recent successful delivery.
