> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Lemlist Sequence Operations: Inputs, Cost & CLI Example
> Adding a step to a Lemlist sequence. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=lemlist_add_sequence_step:{"sequence_id":"{{sequence_id}}","type":"email"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.sequence_id` | `string` | Yes | | Sequence ID (e.g. seq\_abc123) |
| `payload.type` | `"email" \| "linkedinInvite" \| "linkedinSend" \| "linkedinVisit" \| "manual" \| "phone" \| "api" \| "whatsappMessage" \| "conditional" \| "sendToAnotherCampaign"` | Yes | | Step type. email/linkedinSend/linkedinInvite require message; email also requires subject; conditional requires conditionKey + delayType. |
| `payload.delay` | `integer` | No | | Delay before this step executes, in DAYS (never seconds or hours). Non-conditional steps: 0 = immediate, max 90. Conditional steps with delayType "within": number of days to wait for the condition, max 1500. Passing a seconds value (e.g. 259200) will exceed Lemlist's 1500-day limit. |
| `payload.delayType` | `"waitUntil" \| "within"` | No | | Delay type for conditional steps. "waitUntil" pauses until the condition is met. "within" waits up to `delay` DAYS (not seconds) for the condition. |
| `payload.subject` | `string` | No | | Email subject line. Required for email steps. |
| `payload.message` | `string` | No | | Message content (HTML for email, plain text for LinkedIn). Required for email, linkedinSend, and linkedinInvite steps. |
| `payload.index` | `integer` | No | | Position in sequence (-1 or higher) |
| `payload.conditionKey` | `string` | No | | Condition key for conditional steps (e.g. linkedinInviteAccepted, emailsOpened, emailsClicked). Required for conditional steps. |
| `payload.conditions` | `array` | No | | Conditions array - only present in responses. Lemlist auto-generates condition branches; do not send in requests. |
### Allowed values
| Field | Allowed values |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.type` | `email`, `linkedinInvite`, `linkedinSend`, `linkedinVisit`, `manual`, `phone`, `api`, `whatsappMessage`, `conditional`, `sendToAnotherCampaign` |
| `payload.delayType` | `waitUntil`, `within` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Add a step to a Lemlist sequence.",
"properties": {
"sequence_id": {
"type": "string",
"description": "Sequence ID (e.g. seq_abc123)",
"minLength": 1
},
"type": {
"type": "string",
"description": "Step type. email/linkedinSend/linkedinInvite require message; email also requires subject; conditional requires conditionKey + delayType.",
"enum": [
"email",
"linkedinInvite",
"linkedinSend",
"linkedinVisit",
"manual",
"phone",
"api",
"whatsappMessage",
"conditional",
"sendToAnotherCampaign"
]
},
"delay": {
"type": "integer",
"description": "Delay before this step executes, in DAYS (never seconds or hours). Non-conditional steps: 0 = immediate, max 90. Conditional steps with delayType \"within\": number of days to wait for the condition, max 1500. Passing a seconds value (e.g. 259200) will exceed Lemlist's 1500-day limit.",
"minimum": 0
},
"delayType": {
"type": "string",
"description": "Delay type for conditional steps. \"waitUntil\" pauses until the condition is met. \"within\" waits up to `delay` DAYS (not seconds) for the condition.",
"enum": [
"waitUntil",
"within"
]
},
"subject": {
"type": "string",
"description": "Email subject line. Required for email steps.",
"allowsTemplatePlaceholders": true
},
"message": {
"type": "string",
"description": "Message content (HTML for email, plain text for LinkedIn). Required for email, linkedinSend, and linkedinInvite steps.",
"allowsTemplatePlaceholders": true
},
"index": {
"type": "integer",
"description": "Position in sequence (-1 or higher)",
"minimum": -1
},
"conditionKey": {
"type": "string",
"description": "Condition key for conditional steps (e.g. linkedinInviteAccepted, emailsOpened, emailsClicked). Required for conditional steps."
},
"conditions": {
"type": "array",
"description": "Conditions array - only present in responses. Lemlist auto-generates condition branches; do not send in requests.",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Condition key"
},
"label": {
"type": "string",
"description": "Display label"
},
"delay": {
"type": "number",
"description": "Delay for this condition branch"
},
"delayType": {
"type": "string",
"description": "Wait type",
"enum": [
"waitUntil",
"within"
]
},
"sequenceId": {
"type": "string",
"description": "Sequence ID for this branch"
},
"fallback": {
"type": "boolean",
"description": "True if fallback/else branch"
}
},
"additionalProperties": false
}
}
},
"required": [
"sequence_id",
"type"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| --------------- | -------- | -------- | ------- | ----------- |
| `result.status` | `string` | Yes | | |
| `result.result` | `object` | Yes | | |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"result": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sequenceId": {
"type": "string"
},
"type": {
"type": "string"
},
"delayDays": {
"type": "integer"
}
},
"required": [
"id",
"sequenceId",
"type",
"delayDays"
],
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": true
}
},
"required": [
"status",
"result"
],
"additionalProperties": true
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute lemlist_add_sequence_step --payload '{
"sequence_id": "string",
"type": "email"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.