> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yo-lead.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks overview

> Receive YoLead events on your backend.

Webhooks send events from YoLead to your backend. Configure the webhook URL in the YoLead UI.

Your endpoint should:

* accept `POST` requests with JSON bodies;
* verify YoLead webhook signatures;
* respond with `2xx` quickly;
* process events idempotently by event id.

Webhook events are not Public API endpoints and are not listed in the REST OpenAPI reference.

<Note>
  Webhook delivery is initiated by YoLead. Your backend receives the request and returns the HTTP status code for that delivery attempt.
</Note>

## Delivery behavior

YoLead sends webhook requests with:

* method: `POST`;
* content type: `application/json`;
* timeout: 10 seconds;
* max delivery attempts: 4;
* retry backoff: exponential, starting at 60 seconds.

YoLead retries deliveries when your endpoint returns `429` or any `5xx` status. Other `4xx` responses are treated as non-retryable failures.