> ## 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: Get Lead Activity

> Getting the full activity thread for a specific Lemlist lead — sent messages, opens, clicks, and replies. Includes SDK V2 examples, schemas, and cost.

Getting the full activity thread for a specific Lemlist lead — sent messages, opens, clicks, and replies.

> [!NOTE]
>
> Tool ID: `lemlist_get_lead_activity`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'lemlist_get_lead_activity',
  {
    "lead_id": "lead_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute lemlist_get_lead_activity --input '{
  "lead_id": "lead_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": [
    {
      "id": "id_123",
      "type": "example",
      "createdAt": "2026-01-15T12:00:00Z"
    }
  ]
}
```

Use `deepline describe lemlist_get_lead_activity --json` for the latest machine-readable contract.

## Input reference

Get all activities for a specific lead — full conversation thread including sent messages, opens, clicks, and replies.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.lead_id` | `string` | Yes | — | Lemlist lead ID to get activities for Minimum length: 1. |
| `payload.limit` | `integer` | No | `50` | Max number of activities to return Minimum: 1. Maximum: 100. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Get all activities for a specific lead — full conversation thread including sent messages, opens, clicks, and replies.",
    "properties": {
      "lead_id": {
        "type": "string",
        "description": "Lemlist lead ID to get activities for",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "description": "Max number of activities to return",
        "default": 50,
        "minimum": 1,
        "maximum": 100
      }
    },
    "required": [
      "lead_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `array` | Yes | — | Array of activity objects for this lead, ordered by date |
| `result.data[].id` | `string` | Yes | — | Unique activity ID |
| `result.data[]._id` | `string` | No | — | Legacy Lemlist activity ID field |
| `result.data[].type` | `string` | Yes | — | Activity type (e.g. linkedinReplied, emailsReplied) |
| `result.data[].text` | `string` | No | — | Full reply content for LinkedIn messages |
| `result.data[].messagePreview` | `string` | No | — | Truncated reply preview for email messages |
| `result.data[].subject` | `string` | No | — | Email subject line |
| `result.data[].leadId` | `string` | No | — | Lemlist lead ID |
| `result.data[].leadFirstName` | `string` | No | — | Lead first name |
| `result.data[].leadLastName` | `string` | No | — | Lead last name |
| `result.data[].leadEmail` | `string` | No | — | Lead email address |
| `result.data[].firstName` | `string` | No | — | Lead first name (alternate field) |
| `result.data[].lastName` | `string` | No | — | Lead last name (alternate field) |
| `result.data[].email` | `string` | No | — | Lead email (alternate field) |
| `result.data[].fromEmail` | `string` | No | — | Email address the reply came from |
| `result.data[].jobTitle` | `string` | No | — | Lead job title |
| `result.data[].companyDomain` | `string` | No | — | Lead company domain |
| `result.data[].latest_org` | `string` | No | — | Lead company name |
| `result.data[].linkedinUrl` | `string` | No | — | Lead LinkedIn profile URL |
| `result.data[].campaignId` | `string` | No | — | Campaign ID this activity belongs to |
| `result.data[].campaignName` | `string` | No | — | Campaign name |
| `result.data[].sendUserName` | `string` | No | — | Name of the rep who sent the original message |
| `result.data[].sendUserEmail` | `string` | No | — | Email of the sending rep |
| `result.data[].sendUserId` | `string` | No | — | Lemlist user ID of the sending rep |
| `result.data[].sequenceStep` | `number` | No | — | Which step in the sequence triggered this activity |
| `result.data[].totalSequenceStep` | `number` | No | — | Total steps in the sequence |
| `result.data[].sequenceId` | `string` | No | — | Sequence ID |
| `result.data[].emailTemplateId` | `string` | No | — | Email template ID used |
| `result.data[].emailTemplateName` | `string` | No | — | Email template name used |
| `result.data[].isFirst` | `boolean` | No | — | Whether this is the first reply from this lead |
| `result.data[].stopped` | `boolean` | No | — | Whether the sequence was stopped after this activity |
| `result.data[].bot` | `boolean` | No | — | Whether this was detected as a bot reply |
| `result.data[].aiLeadInterestScore` | `number` | No | — | Lemlist AI-scored interest level (0-1). Higher = more interested. |
| `result.data[].createdAt` | `string` | Yes | — | ISO 8601 timestamp of when the activity occurred |
| `result.data[].relatedSentAt` | `string` | No | — | ISO 8601 timestamp of when the original message was sent |
| `result.data[].contactId` | `string` | No | — | Lemlist contact ID |
| `result.data[].teamId` | `string` | No | — | Lemlist team ID |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "array",
        "description": "Array of activity objects for this lead, ordered by date",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Unique activity ID"
            },
            "_id": {
              "type": "string",
              "description": "Legacy Lemlist activity ID field"
            },
            "type": {
              "type": "string",
              "description": "Activity type (e.g. linkedinReplied, emailsReplied)"
            },
            "text": {
              "type": "string",
              "description": "Full reply content for LinkedIn messages"
            },
            "messagePreview": {
              "type": "string",
              "description": "Truncated reply preview for email messages"
            },
            "subject": {
              "type": "string",
              "description": "Email subject line"
            },
            "leadId": {
              "type": "string",
              "description": "Lemlist lead ID"
            },
            "leadFirstName": {
              "type": "string",
              "description": "Lead first name"
            },
            "leadLastName": {
              "type": "string",
              "description": "Lead last name"
            },
            "leadEmail": {
              "type": "string",
              "description": "Lead email address"
            },
            "firstName": {
              "type": "string",
              "description": "Lead first name (alternate field)"
            },
            "lastName": {
              "type": "string",
              "description": "Lead last name (alternate field)"
            },
            "email": {
              "type": "string",
              "description": "Lead email (alternate field)"
            },
            "fromEmail": {
              "type": "string",
              "description": "Email address the reply came from"
            },
            "jobTitle": {
              "type": "string",
              "description": "Lead job title"
            },
            "companyDomain": {
              "type": "string",
              "description": "Lead company domain"
            },
            "latest_org": {
              "type": "string",
              "description": "Lead company name"
            },
            "linkedinUrl": {
              "type": "string",
              "description": "Lead LinkedIn profile URL"
            },
            "campaignId": {
              "type": "string",
              "description": "Campaign ID this activity belongs to"
            },
            "campaignName": {
              "type": "string",
              "description": "Campaign name"
            },
            "sendUserName": {
              "type": "string",
              "description": "Name of the rep who sent the original message"
            },
            "sendUserEmail": {
              "type": "string",
              "description": "Email of the sending rep"
            },
            "sendUserId": {
              "type": "string",
              "description": "Lemlist user ID of the sending rep"
            },
            "sequenceStep": {
              "type": "number",
              "description": "Which step in the sequence triggered this activity"
            },
            "totalSequenceStep": {
              "type": "number",
              "description": "Total steps in the sequence"
            },
            "sequenceId": {
              "type": "string",
              "description": "Sequence ID"
            },
            "emailTemplateId": {
              "type": "string",
              "description": "Email template ID used"
            },
            "emailTemplateName": {
              "type": "string",
              "description": "Email template name used"
            },
            "isFirst": {
              "type": "boolean",
              "description": "Whether this is the first reply from this lead"
            },
            "stopped": {
              "type": "boolean",
              "description": "Whether the sequence was stopped after this activity"
            },
            "bot": {
              "type": "boolean",
              "description": "Whether this was detected as a bot reply"
            },
            "aiLeadInterestScore": {
              "type": "number",
              "description": "Lemlist AI-scored interest level (0-1). Higher = more interested."
            },
            "createdAt": {
              "type": "string",
              "description": "ISO 8601 timestamp of when the activity occurred"
            },
            "relatedSentAt": {
              "type": "string",
              "description": "ISO 8601 timestamp of when the original message was sent"
            },
            "contactId": {
              "type": "string",
              "description": "Lemlist contact ID"
            },
            "teamId": {
              "type": "string",
              "description": "Lemlist team ID"
            }
          },
          "required": [
            "id",
            "type",
            "createdAt"
          ],
          "additionalProperties": false
        }
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Lemlist provider guide](https://deepline.com/docs/providers/lemlist/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.