# Webhooks

Subscribe to events via webhooks

## List webhooks

 - [GET /integrations/api/webhooks](https://api.getsales.io/bundled/webhooks/listwebhooks.md): Retrieve a paginated list of all webhooks configured for your team. You can filter by event type, status, and search query. Results are ordered by creation date in descending order by default.

## Create webhook

 - [POST /integrations/api/webhooks](https://api.getsales.io/bundled/webhooks/createwebhook.md): Create a new webhook to receive real-time notifications for specified events. The webhook will POST (or use another HTTP method) to your target URL when events occur. Webhooks are team-scoped and require a valid event type and publicly accessible target URL.

## Get webhook details

 - [GET /integrations/api/webhooks/{uuid}](https://api.getsales.io/bundled/webhooks/getwebhookdetails.md): Retrieve detailed information about a specific webhook by its UUID. This includes all configuration details, event type, filters, and timestamps.

## Update webhook

 - [PUT /integrations/api/webhooks/{uuid}](https://api.getsales.io/bundled/webhooks/updatewebhook.md): Update an existing webhook's configuration. You can modify the target URL, event type, HTTP method, name, filters, or enable/disable the webhook. The target_url is required, but other fields are optional.

## Delete webhook

 - [DELETE /integrations/api/webhooks/{uuid}](https://api.getsales.io/bundled/webhooks/deletewebhook.md): Permanently delete a webhook. This action cannot be undone. No further events will be delivered to the target URL.

## Test webhook

 - [POST /integrations/api/webhooks/test](https://api.getsales.io/bundled/webhooks/testwebhook.md): Send a test payload to a webhook endpoint to verify connectivity and integration without waiting for a real event to trigger. Returns execution details including response status, headers, and timing information.