Waitlist API reference

Waitlist API · Webhooks

post/v1/workspaces/{workspace_id}/webhooks/{id}/rotate-secretAuth

Rotate the signing secret. Returns the new secret in clear EXACTLY ONCE; the old one stops at once.

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 · uuid

Id of the workspace.

id*string · uuid

Id of the webhook.

Response · 201 Secret rotated. Includes the new plaintext secret exactly once.

id*string · uuid
secret*string

New plaintext signing secret, returned EXACTLY ONCE. Persist immediately — it does not appear on subsequent GETs.

Example

Request

POST https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/webhooks/{id}/rotate-secret
Authorization: Bearer YOUR_TOKEN

Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "secret": "string"
}