/v1/workspaces/{workspace_id}/webhooksAuthCreate a workspace webhook. The response includes the signing secret in clear EXACTLY ONCE — copy it now.
Deprecated: use `/v1/workspaces/{workspace_id}/webhooks/endpoints` (event descriptions, Send test that reports the result, event log, replay, rotation with a grace period). Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.
Path parameters
workspace_id*string · uuidId of the workspace.
Headers
Idempotency-KeystringStripe-style idempotency key. The signing secret is returned exactly once; a retry without this header creates a second webhook + secret you never see the plaintext for. 24h TTL.
Request body
url*stringDestination URL (must be https in prod)
events*arrayEvents to subscribe to
Example: ["entry.created","entry.approved"]
activebooleanDisabled webhooks store events but never deliver
Response · 201 Webhook created. Includes plaintext `signing_secret` exactly once.
id*stringworkspace_id*stringurl*stringevents*arraySubscribed events (`event_types` on the new routes).
active*booleanWhether it receives events (`enabled` on the new routes).
failure_count*numberFailed deliveries in a row (`consecutive_failures` on the new routes).
last_status_code*numberHTTP status of the latest attempt.
last_attempt_at*stringWhen the latest attempt was made.
auto_disabled_at*stringSet when it was switched off automatically after sustained failures.
first_failure_at*stringcreated_at*stringsecret_setbooleanAlways true: every webhook has a signing secret.
signing_secret*stringPlaintext signing secret (`whsec_…`), returned EXACTLY ONCE. Persist immediately; it does not appear on later reads.
secret_one_time_reveal*stringThe same secret as `signing_secret`, under the name older clients read.
Example
Request
POST https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/webhooks
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"url": "string",
"events": [
"entry.created",
"entry.approved"
],
"active": false
}Response
{
"id": "string",
"workspace_id": "string",
"url": "string",
"events": [
"entry.created"
],
"active": false,
"failure_count": 0,
"last_status_code": 0,
"last_attempt_at": "string",
"auto_disabled_at": "string",
"first_failure_at": "string",
"created_at": "string",
"secret_set": false,
"signing_secret": "string",
"secret_one_time_reveal": "string"
}