Lemlist: Get Contacts Idoremail Notes

List the notes on a Lemlist contact, by contact ID or email.

Tool ID: lemlist_get_contacts_idoremail_notes

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.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'lemlist_get_contacts_idoremail_notes',
  {
    "idOrEmail": "jane.doe@example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute lemlist_get_contacts_idoremail_notes --input '{
  "idOrEmail": "jane.doe@example.com"
}' --json

Example response

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

{
  "data": {
    "data": [
      {
        "_id": "_123",
        "teamId": "team_123",
        "contactId": "contact_123"
      }
    ],
    "total": 123
  }
}

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

Input reference

Retrieves the notes attached to a contact, newest first by default. The contact is resolved by its id (ctc_xxx) or email within your team. Only notes are returned, not the contact’s other activities. Use page and limit to paginate: the response carries the page in data and the number of notes in total. A contact without notes answers 200 with an empty data.

Name	Type	Required	Default	Details
`payload.idOrEmail`	`string`	Yes	—	The unique identifier (`ctc_xxx`) or email of the contact
`payload.limit`	`integer`	No	—	Number of notes per page. Default: 100. Maximum: 100. A missing, invalid or non-positive value falls back to 100.
`payload.page`	`integer`	No	—	Page number to retrieve, starting at 1. Default: 1. An invalid value falls back to 1. A page beyond the last one answers an empty `data`.
`payload.sortBy`	`"createdAt"`	No	—	The field to sort by. Only `createdAt` is supported. any other value is ignored. Allowed: `createdAt`.
`payload.sortOrder`	`"asc" \| "desc"`	No	—	The sort direction. Default: `desc` (newest first). Any other value sorts ascending. Allowed: `asc`, `desc`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`array`	Yes	—	—
`result.data.data[]._id`	`string`	No	—	Unique note identifier (`act_xxx`)
`result.data.data[].teamId`	`string`	No	—	Team ID that owns the contact
`result.data.data[].contactId`	`string`	No	—	Parent contact ID (`ctc_xxx`)
`result.data.data[].note`	`string`	No	—	Note text content
`result.data.data[].userId`	`string`	No	—	ID of the user who wrote the note
`result.data.data[].createdAt`	`string`	No	—	Creation timestamp Format: `date-time`.
`result.data.total`	`integer`	Yes	—	Number of notes attached to the contact, across all pages
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

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

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation