Managing Webhooks

Manage webhook subscriptions from Project Settings → Webhooks (one project) or Workspace Settings → Webhooks (all projects in the workspace). Both surfaces offer the same lifecycle; the workspace page adds a Project column and a project picker when creating.

Create a webhook

1. Open Webhooks in Project or Workspace settings and choose Add webhook.

2. Enter the Payload URL — the endpoint that will receive deliveries.

3. (Workspace level only) pick the Project whose events this webhook listens to.

4. Select one or more Events from the grouped checklist (Defects, Test runs, Requirements, Releases). See Events.

5. Create. Hawzu shows the signing secret once — copy and store it now; it can’t be retrieved later.

Caution

Use a URL that responds directly, with no redirect. A redirect (e.g. http → https, or one that adds a trailing slash) downgrades the delivery POST to a GET, which fails with 405 Method Not Allowed.

Send a test event

Use the Send test event (paper-plane) action on a row to queue a synthetic webhook.test delivery to the endpoint — a quick way to confirm the URL is reachable and your signature check works. It appears in the row’s delivery history marked test.

Enable, disable, edit

• Toggle the Active / Paused switch to stop or resume deliveries without deleting the webhook. A paused webhook receives nothing.
• Edit (pencil) to change the URL or the subscribed events. Editing does not rotate the signing secret.
• Delete (trash) removes the webhook and its delivery history. This can’t be undone.

Delivery history & redeliver

Expand a webhook row to see its recent deliveries — event, status (pending / success / failed), HTTP response code, attempt count, and time. Failed deliveries are retried automatically a few times. Use Redeliver (refresh) on any past delivery to replay it with the same payload — handy after fixing your endpoint.

Tip

A delivery is success when your endpoint returns a 2xx. Anything else is failed and retried; the response code is recorded so you can debug.

Next steps

• Webhooks overview — the delivery envelope and signature verification.
• Events — payload shapes for every event.