# What are hooks?

> Hooks let you trigger an external action — like calling a webhook URL — whenever something happens in a chat, such as an agent completing a turn or using a tool.

canonical: https://agentsky.dev/help/hooks-overview
source: https://agentsky.dev/help/hooks-overview.md
updated: 2026-10-22

---

**Hooks let you trigger an external action — like calling a webhook URL — whenever something happens in a chat, such as an agent completing a turn or using a tool.**

Hooks are attached to an agent's configuration and fire automatically. Common uses: post results to a Slack channel, log tool calls to your own system, or trigger a pipeline when the agent finishes.

To set up a hook:

1. Open Developer & API › API agents and choose your agent.
2. In the Hooks section, add a hook: choose the trigger event and enter the target URL.
3. Save.

Where: Web › Developer & API › API agents › your agent › Hooks. Also manageable via the `/api/v1` API.

Trigger events include: turn completed, tool called, and goal reached. Hook payloads contain the event type and relevant context. Related: [Apply rules to every agent in a workspace](https://agentsky.dev/help/workspace-hooks), [What are automations?](https://agentsky.dev/help/automations-overview).