# Work with webhook events

Connect a reviewed destination and inspect delivery evidence.

Canonical page: https://jobhunt.app/support/developers/webhooks/receive-workspace-events
Updated: 2026-10-24
Audience: developers
Topic: Webhooks
Type: how-to
Catalog revision: f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f
Contract SHA-256: acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e

## Steps

1. **Review the destination and events**

   Use the subscription creation review and explicit consent flow. Configuration needs webhook authority and the source-data grants required for the selected events.

2. **Retain signing material privately**

   Follow the recipient-encrypted delivery contract. Keep decryption local, verify private retention, then acknowledge delivery.

3. **Inspect attempts before retrying**

   Use delivery and job reads for factual status. A missing receiver reply does not prove the receiver rejected the event.

## Expected result

Webhook configuration, signing delivery and asynchronous delivery remain separate recorded operations.

## Troubleshooting and recovery

Test and retry actions can contact the configured destination. A status read or bookkeeping reconciliation does not itself authorize another send.

## API operations

### list_webhook_subscriptions

Read every owned nonfinancial webhook subscription in stable ID pages of 25, including inactive subscriptions. Directory omits URL/events; get the complete native metadata or its checksummed file. No signing secret. Reads create nothing and require the captured account.

- Interface: GET /api/v1/journey/list_webhook_subscriptions
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:webhooks
- [Operation and exact schemas](https://jobhunt.app/support/operations/list_webhook_subscriptions.json)
- [Operation Markdown](https://jobhunt.app/support/operations/list_webhook_subscriptions.md)

### list_webhook_deliveries

Read native delivery-attempt history for one owned webhook in stable ID pages of 25. Failed and successful attempts remain distinct from queued worker jobs; directory omits error details; get complete native attempt metadata or its checksummed file. No payload, response body or signing secret.

- Interface: GET /api/v1/journey/list_webhook_deliveries
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:webhooks
- [Operation and exact schemas](https://jobhunt.app/support/operations/list_webhook_deliveries.json)
- [Operation Markdown](https://jobhunt.app/support/operations/list_webhook_deliveries.md)

### list_webhook_delivery_jobs

List the delivery jobs of one webhook subscription in pages of 25. Review and explicitly queue one synthetic webhook.test using the saved destination and signing service, or inspect owned existing durable delivery facts and reconcile only a matching committed HTTP2xx receipt. Exact account/source/actor review, true consent, shared receipts and deterministic receiver key; no automatic new request. No arbitrary payload, signing key, private event/response body or synchronous external IO. Paused subscriptions may receive an explicitly authorized synthetic test, preserving native test behavior; ordinary events remain paused. Reconciliation never sends or changes receiver receipts. Unconfirmed/failed/legacy outcomes stay factual and require separate review.

- Interface: GET /api/v1/journey/list_webhook_delivery_jobs
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:webhooks
- [Operation and exact schemas](https://jobhunt.app/support/operations/list_webhook_delivery_jobs.json)
- [Operation Markdown](https://jobhunt.app/support/operations/list_webhook_delivery_jobs.md)

## Related guides

- [Make your first API request](https://jobhunt.app/support/developers/getting-started/first-request.md)
- [Authentication and permissions](https://jobhunt.app/support/developers/authentication/scopes-and-accounts.md)
- [Connect through MCP](https://jobhunt.app/support/developers/mcp/connect-your-assistant.md)
