# Sequences

> Multi-step outreach sequences whose steps send email through mail-sync, create work items or wait. Each sequence runs as an enrollment program, and a reply on the thread or from the recipient's address ends their run.

- Category: CRM & sales
- Module: `sequences`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/sequences
- Page: https://bettersupabase.com/blocks/sequences

## Install

```bash
npx better-supabase add sequences
```

The command also installs `updated-at`, `tenant`, `access`, `enrollments`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by sequences; add installs them too.
    "updated-at": {},
    tenant: {},
    access: {},
    enrollments: {},
    // Modes: "managed", "custom". The default is "managed".
    sequences: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/sequences`.

## Events

- `sequence.deleted`
- `sequence.saved`
- `sequence_enrollment.completed`
- `sequence_enrollment.created`
- `sequence_enrollment.exited`
- `sequence_enrollment.paused`
- `sequence_enrollment.resumed`
- `sequence_enrollment.step_completed`

## Related blocks

Requires: [tenant](https://bettersupabase.com/blocks/tenant.md), [access](https://bettersupabase.com/blocks/access.md), [enrollments](https://bettersupabase.com/blocks/enrollments.md)

Works with: [mail-sync](https://bettersupabase.com/blocks/mail-sync.md), [parties](https://bettersupabase.com/blocks/parties.md), [work-items](https://bettersupabase.com/blocks/work-items.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)

## Recipes

- [Sequence builder](https://bettersupabase.com/recipes/sequence-builder.md): Each sequence's email, wait and task steps in order, with its enrollment counts, an Add step dialog and an Activate or Pause button.
