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

# followup

> Create, update, complete, and track follow-up reminders.

Follow-ups are your to-do list for staying in touch. Schedule a call, email, meeting, or any other action tied to a contact, and track it through to completion.

## moss followup list

List follow-ups with optional filtering.

```bash theme={null}
moss followup list
moss followup list --contact-id cnt_abc123 --status pending
moss followup list --type call --overdue
```

| Option              | Required | Description                                          |
| ------------------- | -------- | ---------------------------------------------------- |
| `--page <n>`        | No       | Page number                                          |
| `--per-page <n>`    | No       | Items per page                                       |
| `--sort <field>`    | No       | Sort field                                           |
| `--order <dir>`     | No       | Sort order (`asc` or `desc`)                         |
| `--contact-id <id>` | No       | Filter by contact                                    |
| `--deal-id <id>`    | No       | Filter by deal                                       |
| `--status <status>` | No       | Filter by status (`pending`, `completed`, `skipped`) |
| `--type <type>`     | No       | Filter by type (`call`, `email`, `meeting`, `other`) |
| `--overdue`         | No       | Show only overdue follow-ups                         |
| `--due <date>`      | No       | Filter by due date (`YYYY-MM-DD`)                    |

## moss followup show

Show details for a single follow-up.

```bash theme={null}
moss followup show --id fu_abc123
```

| Option      | Required | Description  |
| ----------- | -------- | ------------ |
| `--id <id>` | Yes      | Follow-up ID |

## moss followup create

Create a new follow-up.

```bash theme={null}
moss followup create \
  --contact-id cnt_abc123 \
  --type call \
  --description "Follow up on proposal" \
  --due-date 2026-02-15
```

| Option                 | Required | Description                                  |
| ---------------------- | -------- | -------------------------------------------- |
| `--contact-id <id>`    | Yes      | Contact ID                                   |
| `--type <type>`        | Yes      | Type: `call`, `email`, `meeting`, or `other` |
| `--deal-id <id>`       | No       | Associated deal ID                           |
| `--description <text>` | No       | Description                                  |
| `--due-date <date>`    | No       | Due date (`YYYY-MM-DD`)                      |

## moss followup update

Update an existing follow-up.

```bash theme={null}
moss followup update --id fu_abc123 --due-date 2026-02-20 --type email
```

| Option                 | Required | Description                                  |
| ---------------------- | -------- | -------------------------------------------- |
| `--id <id>`            | Yes      | Follow-up ID                                 |
| `--type <type>`        | No       | Type: `call`, `email`, `meeting`, or `other` |
| `--description <text>` | No       | Description                                  |
| `--due-date <date>`    | No       | Due date (`YYYY-MM-DD`)                      |
| `--status <status>`    | No       | Status (`pending`, `completed`, `skipped`)   |

## moss followup complete

Mark a follow-up as completed.

```bash theme={null}
moss followup complete --id fu_abc123
```

| Option      | Required | Description  |
| ----------- | -------- | ------------ |
| `--id <id>` | Yes      | Follow-up ID |

## moss followup today

List follow-ups due today.

```bash theme={null}
moss followup today
```

| Option           | Required | Description    |
| ---------------- | -------- | -------------- |
| `--page <n>`     | No       | Page number    |
| `--per-page <n>` | No       | Items per page |

## moss followup overdue

List overdue follow-ups.

```bash theme={null}
moss followup overdue
```

| Option           | Required | Description    |
| ---------------- | -------- | -------------- |
| `--page <n>`     | No       | Page number    |
| `--per-page <n>` | No       | Items per page |

## moss followup bulk-complete

Complete multiple follow-ups at once.

```bash theme={null}
moss followup bulk-complete --ids fu_a1,fu_b2,fu_c3 --confirm
```

| Option        | Required | Description                       |
| ------------- | -------- | --------------------------------- |
| `--ids <ids>` | Yes      | Comma-separated follow-up IDs     |
| `--confirm`   | Yes      | Confirm bulk operation (required) |

## moss followup delete

Delete a follow-up.

```bash theme={null}
moss followup delete --id fu_abc123 --confirm
```

| Option      | Required | Description                                            |
| ----------- | -------- | ------------------------------------------------------ |
| `--id <id>` | Yes      | Follow-up ID                                           |
| `--confirm` | Yes      | Confirm deletion (required for destructive operations) |