start_dynamic_sequences

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, candidateCount, and candidatesAlreadyInSequenceElsewhere (talents skipped because they already have an active sequence on another campaign). Poll progress with get_candidate_dynamic_sequence_status for each candidateId.

LinkedIn InMail sender

A LinkedIn InMail step without a chosen sender is sent from the LinkedIn account of the user who owns the API key. An InMail sender already chosen in Kalent is always kept. The blueprint itself is not modified. That user must have a synced LinkedIn account with InMail capability (Recruiter or Sales Navigator). Otherwise the start fails with linkedin_not_connected_or_syncing or linkedin_inmail_not_available.

The default sender is the owner of the API key, not the person chatting with the assistant. If several people share one key, InMails go out from the key owner’s LinkedIn account.

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.

{
  "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:

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

Getting Started

Embedded

Platform

start_dynamic_sequences

Input

Output

LinkedIn InMail sender

Account connection actions

Errors

​Input

​Output

​LinkedIn InMail sender

​Account connection actions

​Errors

Input

Output

LinkedIn InMail sender

Account connection actions

Errors