# Webhooks

Webhooks are event-driven HTTP callbacks that notify external systems when Records are created, updated, deleted, archived, restored, or when specific events occur (e.g., FormSubmissionEvent, PropertyValueChanged, RelationCreated). Webhooks support filtering to only trigger on Records matching specific criteria, retry logic with configurable backoff, relation inclusion for sending related Record data, and multiple payload formats (LEGACY, structured). Webhooks enable integrations with external systems, automation workflows, and real-time data synchronization. They can be associated with Apps for third-party integrations and support secret-based authentication. Webhooks are essential for building event-driven architectures and connecting Caraer with external tools and services.

## Fetch webhooks for the current company

 - [POST /api/v2/webhooks/index](https://developer.caraer.com/apis/webhooks/getwebhooks.md): Retrieves a paginated list of webhooks associated with the authenticated user's selected company. The list can be filtered and sorted using the provided pagination request.

## Fetch webhooks by topic

 - [POST /api/v2/webhooks/index/{topic}](https://developer.caraer.com/apis/webhooks/getwebhooks_1.md): Retrieves a paginated list of webhooks that match the specified topic substring for the authenticated user's company.

## Create a webhook for an app

 - [POST /api/v2/webhooks/apps/{appUuid}](https://developer.caraer.com/apis/webhooks/createappwebhook.md): Creates a new webhook for the specified app using normal bearer authentication. The app must be installed for the authenticated user's selected company. The request body must contain the webhook's secret, topic, and URL.

## Create a new webhook

 - [POST /api/v2/webhooks/](https://developer.caraer.com/apis/webhooks/createwebhook.md): Creates a new webhook for the authenticated user's selected company. The request body must contain the webhook's secret, topic, and URL.

## Get current user's company information

 - [GET /api/v2/webhooks/me](https://developer.caraer.com/apis/webhooks/getcompanyinformation.md): Retrieves the company information of the authenticated user. The response includes public details of the user's selected company.

## Get available webhook formats

 - [GET /api/v2/webhooks/formats](https://developer.caraer.com/apis/webhooks/getwebhookformats.md): Returns all supported webhook payload formats with their details.

## Delete a webhook

 - [DELETE /api/v2/webhooks/{uuid}](https://developer.caraer.com/apis/webhooks/deletewebhook.md): Deletes a webhook identified by its unique key.