Skip to main content
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.
Webhook delivery is initiated by YoLead. Your backend receives the request and returns the HTTP status code for that delivery attempt.

​
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.