> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Webhook examples > Browse event-specific webhook walkthroughs, prerequisites, and payload examples. For the exhaustive schema-derived catalog, see [all examples](/en/api-reference/guides/examples/webhook-examples/webhook-payload-examples). ## What it is Browse event-specific webhook walkthroughs, prerequisites, and payload examples. ## Before you begin * Create a public HTTPS endpoint in your application. * Configure a YCloud webhook endpoint for the event types you need. * Store the endpoint signing secret securely. * Make event processing idempotent. ## How it works YCloud sends an HTTP `POST` request when the event occurs. Verify the signature, durably record the event, return a `2xx` response, and process slow work asynchronously. ## Request The scenarios below show requests delivered to your webhook URL. Treat the event `id` as the delivery identifier and use `type` to route the payload. ## Response Return a `2xx` status after accepting the event. ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK ``` For endpoint setup, signature validation, and retry behavior, see [Configure webhooks](/en/api-reference/guides/api-fundamentals/configure-webhooks). ## Message and template events Handle approved, rejected, paused, disabled, and archived template states. Handle sent, delivered, read, and failed outbound messages. Parse text, media, location, contact, interactive, commerce, and system messages. Process WhatsApp payment transaction changes. ## Echo and Agent handover events For Agents onboarded through the Public REST API, use these event-specific walkthroughs. Console-created Agents use a separate Inbox synchronization flow. Store outbound text and media echoes. Handle delivered, read, late sent, and failed status updates. Observe control handover and understand its correlation limits. ## Account, app, and Flow events Handle eligibility, location, violation, restriction, and account state changes. Synchronize historical inbound and outbound messages. Synchronize messages sent from the WhatsApp Business App. Process Flow lifecycle status changes. ## Calling and group events Handle SDP offers and answers for WhatsApp calls. Handle ringing, accepted, and rejected call states. Handle completed and failed call termination. Handle group creation and deletion. Handle participant and join-request changes. Handle group subject and description changes. Handle group suspension and reinstatement. ## Contact events Process newly created contacts. Remove or reconcile deleted contacts. Process profile, custom attribute, and tag changes. Handle newly created opt-out records. Handle deleted opt-out records. Browse every event type and all named payload examples from the OpenAPI specification. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.