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

# Automations

> Run Kairo instructions on a schedule or trigger them from external services.

{/* Opening: what an automation is in one paragraph. */}

An automation is a saved instruction that Kairo runs when triggered — either on a schedule (every weekday at 8am) or when an external service hits a webhook URL.

## Two kinds of triggers

<CardGroup cols={2}>
  <Card title="Schedule" icon="clock">
    Cron-style. *"Every Monday at 9am, send me my open todos and this week's calendar."*
  </Card>

  <Card title="Webhook" icon="webhook" href="/automations/webhook-triggers">
    A unique URL anyone can `POST` to. Useful for GitHub Actions, Linear, monitoring tools.
  </Card>
</CardGroup>

## Common patterns

{/* - Daily digest: "every weekday at 8am send me my todos + calendar" */}

{/* - End-of-day journaling prompt */}

## Creating a schedule automation

{/* - From chat: "every weekday at 8am send me my open todos" — Kairo confirms */}

{/* - Cron expressions are supported but you don't need to know them */}

## Creating a webhook automation

Webhook automations are created in the web app (Automations → New → Webhook). The full caller-side contract — URL shape, idempotency, rate limits, rotation — lives in [Webhook triggers](/automations/webhook-triggers).

## Pausing, resuming, deleting

{/* - From chat: "pause #2", "resume #2", "cancel #1" (after listing) */}

{/* - Auto-pause after 5 consecutive failures */}

## Run history

{/* - Every run is recorded: time, payload (for webhooks), reply, status, duration */}
