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

# How to create a mission in Chatbase

> Start from a template, a short description of your goal, or a blank mission, then test and publish it.

Nothing is saved until you click **Create mission**, and nothing runs until you publish.

Go to **Build > Missions** and click **New mission**.

## The Missions page

**My missions** lists every mission on the AI agent.

![The My missions tab](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/missions-list.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=1a2cfbd433f178815f830db7ea7639f6)

| Column | Shows |
| - | - |
| **Name** | The mission. Click it to open it. |
| **Trigger** | **Signal** when a rule starts runs, **Manual** when you start them. |
| **Open runs** | Runs still going. |
| **Status** | **Draft**, **Live**, or **Paused**. |
| **Needs you** | Runs waiting for your approval or answer. |
| **Goal reached** | Runs that reached the goal, out of all runs. |
| **Last updated** | When it last changed. |

You can search, filter by status, and sort by name, open runs, or last updated. The **⋯** menu on each row opens, publishes, pauses, or resumes the mission.

When runs need you, the **Missions** item in the sidebar shows how many.

## Start from a template

Open the **Templates** tab. Each template is a working mission. Fill in a few details, test it, and publish.

![The Templates tab](https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/templates.png?fit=max\&auto=format\&n=J9oopG46WMTX3-j2\&q=85\&s=94d11af513a5f328e86590412c7e66a5)

| Template | What it does | Starts when |
| - | - | - |
| **Reach out to a list** | Emails each person on a list you choose and follows up until they reply or say no. | You start it from Contacts or a file |
| **Turn trials into paid** | Helps trial users get value and upgrade before the trial ends. | `trial_started` arrives |
| **Re-engage cold leads** | Restarts leads that went quiet, then revives or closes each one. | `lead_went_cold` arrives |
| **Activate new customers** | Walks new customers through their first key steps and flags anyone stuck. | `onboarding_started` arrives |
| **Ask for reviews and referrals** | Asks happy customers for a review or an introduction. | `happy_customer` arrives |

The other templates start on an event, so your product has to send that event. See [Send events to Chatbase](https://chatbase.co/docs/user-guides/missions/signals-and-events.md#send-events-to-chatbase).

Click a template to read its full setup, then click **Use template**. Templates send only on weekdays, 9:00 to 18:00 in your time zone. You can change that in [Guardrails](https://chatbase.co/docs/user-guides/missions/configure-a-mission.md#guardrails).

## Describe your mission

Write what customers should achieve in plain words, up to 2,000 characters. For example: "If the company has fewer than 50 people, get them to start a free trial. If it's bigger, get them on a call." Or click one of the suggestions under the box.

Click **Draft mission** and wait about 20 seconds. The draft fills in:

* The name, goal, and instructions
* Whether each person gets their own run, or a company shares one
* Up to 8 steps it always takes
* One to five outcomes with dollar values, and up to 4 milestones
* How many days to try before giving up
* Up to 5 lines of exact wording

Read the draft before you create it. If drafting fails, click **Try again**.

## Start from scratch

Click **Start from scratch** on the Templates tab. You get a blank mission with default settings. [Configure a mission](https://chatbase.co/docs/user-guides/missions/configure-a-mission.md) walks through each card.

## Fill in placeholders

Templates and drafts can leave blanks in double square brackets, like `[[your product name]]`. A notice at the top counts them. Click one to jump to its field. You can't publish until they're all filled.

## Create and check the mission

Click **Create mission** at the bottom. It's saved as a Draft, and **Test run** and **Publish** turn on.

If something is missing, the header shows a **N to fix** button. Click it to see what's wrong:

| Check | How to fix it |
| - | - |
| **A way to reach people** | Turn on email, WhatsApp, phone calls, or in-app messages. |
| **Every action that's on is set up** | Connect what the action needs, or turn it off. |
| **Placeholders filled** | Fill every `[[placeholder]]`. |
| **Approvals have somewhere to go** | Connect Slack, pick a teammate to email, or show approvals on the run page. |

Each item has a button that opens the right card.

## Test, then publish

Run a [test run](https://chatbase.co/docs/user-guides/missions/test-runs.md) first. You'll see days of work in a few minutes.

When it looks right, click **Publish**. Your start rules begin starting runs, and the agent works on each one until it reaches the goal or gives up.

## Pause and resume

**Pause** stops a live mission. No new runs start, and active runs stop until you resume.

**Resume** picks up every run that was working before the pause, and new runs can start again.

> [!WARNING]
>
> Resuming sends real messages again. Check the waiting runs first.

You can't delete a mission. Pause it instead.


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