# 🔔 Webhooks

## Get available webhook event types

 - [GET /webhooks/event-types](https://pdp-api-v250704-iron.seqino.dev/openapi/webhooks/get_event_types_webhooks_event_types_get.md): Get information about available webhook event types and their payload structures.

This endpoint provides documentation on:
- All available event types you can subscribe to
- Example payload structure for each event type
- Description of what each event represents

Use this information when implementing your webhook endpoint to understand
what data you'll receive for each event type.

Note: The example payloads shown here use Pydantic models that enforce
type safety and validation (see WEBHOOK_EVENT_METADATA).

## Get webhook configuration

 - [GET /webhooks](https://pdp-api-v250704-iron.seqino.dev/openapi/webhooks/get_webhook_webhooks_get.md): Get the current webhook configuration for this sponsor.

Note: The webhook secret is NOT included in this response for security reasons.

## Create webhook endpoint

 - [POST /webhooks](https://pdp-api-v250704-iron.seqino.dev/openapi/webhooks/create_webhook_webhooks_post.md): Create a new webhook for the sponsor.

Only one webhook is allowed per sponsor. The secret is returned only on creation.
Store it securely - it cannot be retrieved later.

The secret is used to generate HMAC-SHA256 signatures for webhook payloads.

You can optionally specify which events to subscribe to. If not provided, the webhook
will receive all available event types.

## Delete webhook

 - [DELETE /webhooks](https://pdp-api-v250704-iron.seqino.dev/openapi/webhooks/delete_webhook_webhooks_delete.md): Delete the webhook configuration for this sponsor.