# Webhook Subscriptions

A webhook subscription defines a target URL that receives HTTP callbacks when specific events occur in the system. Subscriptions can be activated, deactivated, and configured with specific event types to listen for.

## List webhook subscriptions

 - [GET /v1/webhook-subscriptions](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions/get.md): Retrieves a paginated list of webhook subscriptions.

## Create a webhook subscription

 - [POST /v1/webhook-subscriptions](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions/post.md): Creates a new webhook subscription. The subscription is created in inactive status.

## Get a webhook subscription

 - [GET /v1/webhook-subscriptions/{webhookSubscriptionUuid}](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions~1%7Bwebhooksubscriptionuuid%7D/get.md): Retrieves a single webhook subscription by its unique identifier.

## Update a webhook subscription

 - [PATCH /v1/webhook-subscriptions/{webhookSubscriptionUuid}](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions~1%7Bwebhooksubscriptionuuid%7D/patch.md): Updates an existing webhook subscription.

## Delete a webhook subscription

 - [DELETE /v1/webhook-subscriptions/{webhookSubscriptionUuid}](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions~1%7Bwebhooksubscriptionuuid%7D/delete.md): Permanently deletes a webhook subscription.

## Transition webhook subscription lifecycle

 - [PATCH /v1/webhook-subscriptions/{webhookSubscriptionUuid}/actions/lifecycle](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions~1%7Bwebhooksubscriptionuuid%7D~1actions~1lifecycle/patch.md): Transitions a webhook subscription to a different lifecycle state.

## Rotate webhook subscription secret

 - [PATCH /v1/webhook-subscriptions/{webhookSubscriptionUuid}/actions/rotate-secret](https://docs.apiera.io/openapi/webhook-subscriptions/paths/~1v1~1webhook-subscriptions~1%7Bwebhooksubscriptionuuid%7D~1actions~1rotate-secret/patch.md): Rotates the HMAC secret of a webhook subscription.