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

# Setting up workflows

> Learn to create workflows your Superagent runs on a schedule or when a trigger happens, manage them from the Workflows page, and review every run in one place.

Use workflows when you want your Superagent to handle recurring work on its own, such as sending you a morning brief, labeling important emails, pulling the news you care about, or nudging you about anything that needs attention.

A workflow runs on a schedule or when a trigger happens, such as activity in a connected tool. You create workflows by describing what you want in chat, and manage every workflow from the **Workflows** page in the sidebar.

<Card title="What can I use workflows for?" color="#FF5500" icon="diagram-project">
  Workflows handle the work you would otherwise repeat yourself. For example:

  * **Morning briefing:** Every morning, summarize your unread emails, today's meetings, and Slack threads into a digest.
  * **Unanswered email nudge:** When an email sits unread for 24 hours, send a reminder with a one-line summary of what it's about.
  * **Meeting prep:** 30 minutes before each meeting, pull the invite, find related emails and docs, and send a context summary.
  * **End of day wrap-up:** Every evening, summarize what you got done today and draft a short to-do list for tomorrow.
</Card>

***

## How workflows work

Every workflow starts from a schedule or a trigger, then runs the actions you described. When you describe what you want in chat, your Superagent builds the workflow for you, asking any questions it needs, and a card for the new workflow appears in the chat.

The workflow is saved on the **Workflows** page under **Scheduled Workflows** or **Triggered Workflows**, and every run is recorded so you can review what happened.

***

## Choosing a workflow type

It helps to know which type fits your use case when describing what you want.

<Tip>
  You do not need to choose a type yourself. Describe what you want in your own words, and your Superagent works out the right type for you and asks clarifying questions when it needs them.
</Tip>

### Scheduled

Scheduled workflows run at times you define, such as every morning, every Monday, or at the end of each day. Use these for recurring tasks like daily digests and weekly reports.

**For example:**

```text theme={null}
Every morning at 8 AM, summarize my unread Gmail emails and send me a digest.
```

### Triggered

Triggered workflows run when a trigger happens, such as an email arriving in a connected Gmail account or changes to your Superagent's data. Use these to react to activity as it happens.

**For example:**

```text theme={null}
When an email sits unread for 24 hours, send me a reminder with a one-line summary of what it's about.
```

***

## Creating a workflow

Create a workflow from a suggestion, or describe what you want in your own words. Either way, your Superagent builds the workflow in chat.

### Starting from a suggestion

Suggested workflows are ready-made ideas, grouped by categories such as work productivity, business growth, and wellness.

**To create a workflow from a suggestion:**

1. Open your Superagent.
2. Click **Workflows** in the sidebar.
3. Click **New Workflow**.
4. Browse the suggested workflows by category.
5. Click **Send to chat** on the workflow you want to set up.
6. Review the workflow in chat and complete the setup.

### Describing it in chat

Describe the workflow directly in chat when you already know what you want. Your Superagent asks follow-up questions when it needs more detail, and you can keep refining the workflow in chat until it works the way you need.

**For example:**

```text theme={null}
Pull AI, travel, and wellness news every morning at 9 AM.
```

***

## Managing workflows

The **Workflows** page shows each workflow's schedule or trigger, name, and last run date. Filter workflows by **Active**, **Paused**, or **Completed**, or search for one by name.

**To manage a workflow:**

1. Open your Superagent.
2. Click **Workflows** in the sidebar.
3. Do one of the following:

<AccordionGroup>
  <Accordion title="Run a workflow now">
    Click **Run Now** on the workflow to run it immediately, without waiting for its schedule or trigger.
  </Accordion>

  <Accordion title="Pause or resume a workflow">
    1. Click the **More actions** <Icon icon="ellipsis" /> icon on the workflow.
    2. Select **Pause**. To start it again, select **Resume**.
  </Accordion>

  <Accordion title="Archive a workflow">
    1. Click the **More actions** <Icon icon="ellipsis" /> icon on the workflow.
    2. Select **Archive**. To bring it back, select **Restore**.
  </Accordion>
</AccordionGroup>

<Tip>
  You can also ask your Superagent to create, edit, pause, archive, or restore workflows directly in chat.
</Tip>

***

## Monitoring runs

Every run is recorded so you can check what your workflows did and when.

**To review your workflow runs:**

1. Open your Superagent.
2. Click **Workflows** in the sidebar.
3. Do one of the following:

<AccordionGroup>
  <Accordion title="Review recent runs across workflows">
    1) Click the **Activity** tab.
    2) Review the list of runs. Each run shows its date, workflow name, status, and duration.
  </Accordion>

  <Accordion title="Open a workflow's run history">
    1. Click the workflow you want to inspect.
    2. Review its total runs, success rate, average runtime, and run history.

    <Note>
      Workflow details are available on desktop. On mobile, open the workflow on desktop to view its details.
    </Note>
  </Accordion>
</AccordionGroup>

***

## Handling failed runs

Your Superagent watches workflow runs while they are in progress. If a workflow is looping or not working as expected, your Superagent can pause or stop the run to prevent unnecessary credit usage.

Scheduled workflows that fail repeatedly are paused automatically, and you receive a notification so you can review and reactivate them once the issue is resolved.

***

## Workflows and message credits

Workflow runs use your message credits, the same as chatting with your Superagent. To see how many credits your workflows have used, open **Agent Settings** in the sidebar and click **Credit usage**.

***

## FAQs

Click a question below to learn more about workflows.

<AccordionGroup>
  <Accordion title="What is the difference between Superagent workflows and app workflows?">
    They run on the same system. Superagent workflows belong to your agent, are created in its chat, and are managed from its **Workflows** page. App workflows belong to a specific app and are created and managed from that app's dashboard, where they can also react to app events such as data changes, publishes, and payments.

    To learn about app workflows, see [Creating workflows](/Building-your-app/Creating-workflows).
  </Accordion>

  <Accordion title="Where do I see why a workflow run failed?">
    Click the **Activity** tab on the **Workflows** page to review each run's status, or ask your Superagent in chat what happened in the run.
  </Accordion>
</AccordionGroup>