# 🔔 Event Subscriptions

Create and manage webhook subscriptions for entity events.
The Event Subscriptions API provides:
- **Webhook Management** - Create, update, and deactivate webhook subscriptions
- **Event Filtering** - Subscribe to specific entity types and operations (CREATE, UPDATE, DELETE)
- **Security** - Retrieve webhook signing secrets for payload verification

 - [GET /api/v1/event-subscriptions/catalog](https://api.doc.aiwyn.ai/bundle/event-subscriptions/geteventsettingscatalog.md): **Get catalog of available event types** Returns all entity/operation combinations that can be subscribed to. Use the 'enabled' query parameter to filter by enabled status. **Business Applications:**
 - [POST /api/v1/event-subscriptions](https://api.doc.aiwyn.ai/bundle/event-subscriptions/createeventsubscription.md): **Create a webhook subscription for entity events** Subscribe to receive webhook notifications when entities are created, updated, or deleted. The webhook URL must use HTTPS and will receive POST requ
 - [PATCH /api/v1/event-subscriptions/{id}](https://api.doc.aiwyn.ai/bundle/event-subscriptions/updateeventsubscription.md): **Update an existing webhook subscription** Modify subscription properties such as delivery URL, filter expression, or description. Only provided fields will be updated. **Business Applications:** - U
 - [DELETE /api/v1/event-subscriptions/{id}](https://api.doc.aiwyn.ai/bundle/event-subscriptions/deactivateeventsubscription.md): **Deactivate a webhook subscription** Soft-deletes a subscription by marking it as inactive. The subscription can be reactivated later if needed. **Business Applications:** - Stop receiving webhooks -
 - [POST /api/v1/event-subscriptions/{id}/reactivate](https://api.doc.aiwyn.ai/bundle/event-subscriptions/reactivateeventsubscription.md): **Reactivate a webhook subscription** Reactivates a previously deactivated subscription. **Business Applications:** - Restore webhook integrations - Resume event notifications **Real Example:** ```b
 - [GET /api/v1/event-subscriptions/{id}/deliveries](https://api.doc.aiwyn.ai/bundle/event-subscriptions/getwebhookdeliveryhistory.md): **Retrieve webhook delivery attempts for a subscription** Returns a paginated list of delivery attempts for webhook events for the given subscription. Supports filtering by HTTP status code and time r
 - [GET /api/v1/event-subscriptions/webhook/secret](https://api.doc.aiwyn.ai/bundle/event-subscriptions/getsubscriptionsecret.md): **Get the webhook signing secret** Retrieves the secret used to sign webhook payloads. Use this secret to verify webhook authenticity on your server. **Business Applications:** - Webhook signature ver
 - [POST /api/v1/webhook/test/generate](https://api.doc.aiwyn.ai/bundle/event-subscriptions/generatewebhooktestpayload.md): **Generate a signed test webhook payload** Generates a signature for an arbitrary JSON payload using the provided secret. This is intended for debugging webhook integrations. **Business Applications:*
 - [POST /api/v1/webhook/test/validate](https://api.doc.aiwyn.ai/bundle/event-subscriptions/validatewebhooktestsignature.md): **Validate a webhook signature** Verifies that the provided signature matches the payload and secret. This is intended for debugging webhook integrations. **Business Applications:** - Webhook troubles