# Webhook Subscriptions

Manage webhook subscriptions.

## List Webhooks

 - [GET /v1/webhooks](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/listwebhooksubscriptions.md): List the webhooks you have registered

## Register Webhook

 - [POST /v1/webhooks](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/createwebhooksubscription.md): Register an endpoint to start receiving selected webhook events

## List Webhook Secrets

 - [GET /v1/webhooks/secrets](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/listwebhooksecrets.md): This endpoint returns a set of webhook signing secrets used to validate the webhook.
Usually only one key will be returned in the response. After key rotation, this endpoint will return two keys:
the new key, and the key that will be revoked soon. There will also be two signatures in the 'Webhook-Signature' request header.
Your application should use all keys available to validate the webhook request. If validation passes for any
of the keys returned, the webhook payload is valid.

## Get Webhook

 - [GET /v1/webhooks/{id}](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/getwebhooksubscription.md): Get details of a webhook

## Update Webhook

 - [PUT /v1/webhooks/{id}](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/updatewebhooksubscription.md): Update a webhook.
You can update the endpoint url, event types that the endpoint receives, or temporarily deactivate the webhook.

## Unregister Webhook

 - [DELETE /v1/webhooks/{id}](https://developer.brex.com/openapi/webhooks_api/webhook-subscriptions/deletewebhooksubscription.md): Unregister a webhook if you want to stop receiving webhook events