> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.prolific.com/api-reference/webhooks/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.prolific.com/_mcp/server.

# Webhooks

Webhooks deliver event data to your applications as it happens, offering an alternative to frequent data polling.

![Webhooks inbound flow](/_fern-img/8403af96737dcb9aedb239564cb94905a24d74a0780007a2b4f7a2271dd16572.webp)

The flow below shows the inbound nature of hook configuration. This is what is required to register your subscription.

![Webhooks outbound flow](/_fern-img/fe7800b3ab2354c5cb539a11bfdb61dfbc6ad92841361ad33f4ddd12fc9d63f8.webp)

Once your subscription is registered, the flow below shows the outbound nature of hooks.

## Docs

- [Subscribing](https://docs.prolific.com/api-reference/webhooks/subscribing.md)
- [Receiving](https://docs.prolific.com/api-reference/webhooks/receiving.md)
- [Event Delivery and Retry Logic](https://docs.prolific.com/api-reference/webhooks/event-delivery-and-retry-logic.md)
- [Persistent Failures and Disabling Logic](https://docs.prolific.com/api-reference/webhooks/persistent-failures-and-disabling-logic.md)
- [Idempotency and the X-Event-ID Header](https://docs.prolific.com/api-reference/webhooks/idempotency-and-the-x-event-id-header.md)
- [Handling event order with X-Timestamp](https://docs.prolific.com/api-reference/webhooks/handling-event-order-with-x-timestamp.md)
- [Verifying](https://docs.prolific.com/api-reference/webhooks/verifying.md)

## API Docs

- Webhooks [List all subscribable event types](https://docs.prolific.com/api-reference/webhooks/get-event-types.md)
- Webhooks [List all secrets](https://docs.prolific.com/api-reference/webhooks/get-secrets.md)
- Webhooks [Create/replace a secret](https://docs.prolific.com/api-reference/webhooks/create-secret.md)
- Webhooks [List all subscriptions](https://docs.prolific.com/api-reference/webhooks/get-subscriptions.md)
- Webhooks [Create a subscription](https://docs.prolific.com/api-reference/webhooks/create-subscription.md)
- Webhooks [Retrieve a subscription](https://docs.prolific.com/api-reference/webhooks/get-subscription.md)
- Webhooks [Confirm a subscription](https://docs.prolific.com/api-reference/webhooks/confirm-subscription.md)
- Webhooks [Delete a subscription](https://docs.prolific.com/api-reference/webhooks/delete-subscription.md)
- Webhooks [Update a subscription](https://docs.prolific.com/api-reference/webhooks/update-subscription.md)
- Webhooks [Get subscription events](https://docs.prolific.com/api-reference/webhooks/get-events.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.prolific.com/api-reference/webhooks/openapi.json)
- [OpenAPI YAML](https://docs.prolific.com/api-reference/webhooks/openapi.yaml)