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

# Automations

> Run AI prompts on a schedule or after specific events

export const Prompt = ({text, variant = 'accent'}) => {
  const [copied, setCopied] = useState(false);
  const handleCopy = async () => {
    try {
      await navigator.clipboard.writeText(text);
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    } catch {}
  };
  const clipboardIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copy</title>
            <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
            <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
        </svg>;
  const checkIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copied</title>
            <polyline points="20 6 9 17 4 12" />
        </svg>;
  const promptIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style={{
    flexShrink: 0,
    opacity: 0.4
  }}>
            <title>Prompt</title>
            <path d="M20 2H2v20h2V4h16v12H6v2H4v2h2v-2h16V2zM6 7h12v2H6zm8 4H6v2h8z" />
        </svg>;
  return <div className={`prompt prompt-${variant}`} style={{
    marginTop: '12px',
    marginBottom: '12px'
  }}>
            {promptIcon}
            <span className="prompt-text">{text}</span>
            <button className="prompt-copy" onClick={handleCopy} title="Copy to clipboard" type="button">
                {copied ? checkIcon : clipboardIcon}
            </button>
        </div>;
};

**Automations** let you run the Modem Agent without opening chat. You can run a prompt on a schedule or trigger it when a specific event happens.

## How It Works

An automation is a prompt plus a run condition. In the dashboard, you choose a **Type**:

| Type | Best for | Configuration |
| - | - | - |
| **Scheduled** | Digests, recurring checks, and one-time follow-ups | Pick **Daily**, **Repeats**, or **Once** |
| **Trigger** | Reacting to PR or MR activity, topic changes, Stripe billing, Sentry feedback | Pick one or more events (up to 20) that should run the automation |

Automations use the same agent capabilities you use in chat. Depending on what integrations you have connected and which tools you allow, an automation can post to Slack, send email, create Linear issues, link topics to GitHub PRs, or take other actions on your behalf.

For trigger automations, Modem automatically passes the event details to the agent. You do not need template variables or special placeholders in your prompt. Just describe what you want done in plain language.

<Note>
  If your organization has a default output destination, a new automation starts with that destination as its only output. Otherwise, when
  you add Slack as an output, its destination mode defaults to **Any internal destination**. In that mode the agent can DM full members of
  your connected Slack workspace and post in internal channels Modem has joined, but cannot message guests, external users, or Slack
  Connect channels. Automations without a Slack output, including ones the agent creates for you, do not have this restriction. Emails can
  only be sent to members of your Modem organization.
</Note>

## Automation Types

### Scheduled automations

Use scheduled automations when you want a recurring or one-time run.

<Prompt text="Summarize all bug reports from the last week and post the results in #dev" />

<Prompt text="What are the top feature requests from enterprise customers this month? Email the results to product@ourcompany.com" />

<Prompt text="List any new topics about authentication issues since yesterday and DM me on Slack" />

### Trigger automations

Use trigger automations when you want Modem to react as soon as something happens.

Supported events today:

| Source | Events |
| - | - |
| Modem | **Topic Created**, **Topic Priority High**, **Group Added to Topic**, **Group Updated on Topic** |
| GitHub | **GitHub PR Created**, **GitHub PR Merged**, **GitHub PR Dismissed** |
| GitLab | **GitLab MR Created**, **GitLab MR Merged**, **GitLab MR Closed** |
| Stripe | **Stripe Customer Created**, **Stripe Subscription Created**, **Stripe Subscription Canceled**, **Stripe Trial Ending**, **Stripe Payment Failed** |
| Sentry | **Sentry Feedback Created** |

GitHub and Stripe events only appear in the picker once that integration is connected. **Group Added to Topic** and **Group Updated on Topic** currently fire only for X conversations, and an automation using them must be limited to specific channels or products.

<Prompt text="When a GitHub PR is merged, summarize what shipped and post it in #product-updates" />

<Prompt text="When a topic reaches high priority, DM me on Slack with the topic summary and any linked work" />

## Creating an Automation

The easiest way to create an automation is to ask the agent:

<Prompt text="Create a weekly automation that summarizes bug reports every Monday and posts the results in #dev" />

<Prompt text="Create a trigger automation that notifies me when a topic reaches high priority" />

The agent will set up the automation for you, including the prompt and the automation type.

### Creating an automation (manually)

<Steps>
  <Step title="Navigate to Automations">
    Go to **Automations** in your dashboard.
  </Step>

  <Step title="Create a new automation">
    Click **Create Automation** and choose **Create manually**. Give it a name and write the prompt you want the agent to execute.
  </Step>

  <Step title="Choose the automation type">
    Pick **Trigger** or **Scheduled**.
  </Step>

  <Step title="Configure when it runs">
    If you chose **Scheduled**, pick:

    * **Daily** for runs on selected days at a specific time
    * **Repeats** for runs every 30 minutes to 24 hours, on the days you select
    * **Once** for a single future run

    If you chose **Trigger**, add one or more events. Some events can be limited to specific channels, such as GitHub repositories. To wait before running, set a **Delay** of up to 7 days under **More Options**.
  </Step>

  <Step title="Choose tools">
    Under **More Options**, the **Tools** row lists every connected tool, all turned on by default. Turn off any tool you do not want the automation to use.
  </Step>

  <Step title="Activate">
    Save the automation. Scheduled automations run at the configured time. Trigger automations run when a selected event occurs.
  </Step>
</Steps>

## Managing Automations

The automations list shows each automation's type, enabled status, recent runs, and last updated time. Scheduled automations show when they run. Trigger automations show the events they listen for.

You can:

* **Pause and resume** an automation without deleting it
* **Run Once** to start an immediate run of a scheduled automation. Trigger automations only run when their event fires.
* **Edit** the prompt, type, or tools
* **View run history** to see past executions, their results, and any errors

## Related

<CardGroup cols={2}>
  <Card title="The Modem Agent" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/bot.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=2496f9106cb54fa9f4e27ad1f8f3a171" href="/docs/features/agent" width="22" height="22" data-path="icons/bot.svg">
    The same AI that powers automation execution.
  </Card>

  <Card title="GitHub" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/github.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=1241c26b449c582e802cf990e2f41703" href="/docs/integrations/github" width="24" height="24" data-path="icons/github.svg">
    Use PR activity as an automation trigger.
  </Card>

  <Card title="Topics" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/label-alt-multiple.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=e7fbaf23c28396ac670b89cf38e1e4a6" href="/docs/guides/topics" width="24" height="24" data-path="icons/label-alt-multiple.svg">
    Trigger automations when new topics appear or reach high priority.
  </Card>
</CardGroup>


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