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

# start_dynamic_sequences

> Start dynamic outreach sequences from a blueprint for candidates.

Starts a dynamic outreach sequence workflow for the given blueprint and candidate ids in the authenticated MCP workspace.

## Input

| Parameter      | Type      | Required | Description                              |
| -------------- | --------- | -------- | ---------------------------------------- |
| `blueprintId`  | string    | Yes      | Sequence blueprint to start.             |
| `candidateIds` | string\[] | Yes      | Candidate ids to enroll in the sequence. |

## Output

JSON block with `success: true` and `data`: `started`, `blueprintId`, and `candidateCount`.

Poll progress with `get_candidate_dynamic_sequence_status` for each `candidateId`.

## Account connection actions

If required outreach accounts are missing or need attention, the tool returns a structured action payload instead of asking you to visit Kalent settings manually.

```json theme={null}
{
  "success": false,
  "requiresAction": true,
  "action": "open_kalent_messaging_settings",
  "missingAccounts": ["LINKEDIN"],
  "connectionUrl": "https://app.kalent.ai/settings/outreach",
  "retryTool": "start_dynamic_sequences"
}
```

Possible `action` values:

* `open_kalent_messaging_settings` — open `connectionUrl` (Kalent `/settings/outreach`) to connect or reconnect LinkedIn, WhatsApp, or email accounts before retrying.

`missingAccounts` can include `LINKEDIN`, `WHATSAPP`, `EMAIL_GOOGLE`, `EMAIL_OUTLOOK`, or `EMAIL_IMAP`.

## Errors

`session not found`, `Not found`, validation messages, subscription/plan upgrade messages, or Temporal availability messages when the sequence cannot be started.

When the workspace plan does not include outreach integrations, the tool returns an error explaining that the user must subscribe or upgrade before retrying:

```text theme={null}
A Kalent subscription or plan upgrade is required to use outreach integrations.

Ask the user to subscribe or upgrade their Kalent plan before retrying. They can manage billing here: https://app.kalent.ai/settings/billing
```
