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

# Webhooks

> A unique URL for an external event to start a task.

A **webhook** is a URL that belongs to one worker. When another system posts to it, the worker takes what arrived and works on it, and the answer lands in a Slack channel or a person's DM that you named when you created the hook. A form submission, a new ticket, a deploy finishing: anything that can send a web request can start a worker.

Each hook has a name, a destination (a channel the worker is in, or a person linked to it), and a threading choice: every delivery as a new message, each delivery in its own thread, or all deliveries in one thread. You can add an opening line and a template for how the payload is shown.

Hooks are created through the API today; there is no screen for them in control yet. Creating one returns the URL and a secret that starts with `whsec_`, shown once. The caller sends the secret with every delivery. See [The API](https://docs.ergoly.ai/technical/api.md).

> [!NOTE]
>
> **Worth knowing.** A hook on a client's copy of a worker can only post into that client's channels or DM that client's people. If the channel is later moved to another client, deliveries stop until the hook is re-pointed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.