PlatformDocs
MCP server

get_lead_recordings

List session recordings (replays of what a visitor did on your website), newest first, up to 100.

View as Markdown

List session recordings · Read-only

List session recordings (replays of what a visitor did on your website), newest first, up to 100. Pass clientId to list a website's recordings, or email to list one identified visitor's recordings. Each recording has session_id, client_id, lead_email, started_at, ended_at, duration_ms, page_count, first_page and finalized. Recordings exist only when session recording is enabled for the website. clientId comes from get_website or get_tracking_pixel; the email is the lead's exactPerson email from get_leads. To watch one, pass its session_id and client_id to get_recording_url. At least one of clientId or email is required. Read-only.

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredAcceptsDescription
clientIdstringNoanyThe website's clientId (16-32 characters) from get_website or get_tracking_pixel.
emailstringNoanyEmail address of an identified visitor (from get_leads). When given, the list is the recordings for this email.

Tool definition

What your assistant receives from tools/list:

{
  "name": "get_lead_recordings",
  "title": "List session recordings",
  "annotations": {
    "title": "List session recordings",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "clientId": {
        "type": "string",
        "description": "The website's clientId (16-32 characters) from get_website or get_tracking_pixel."
      },
      "email": {
        "type": "string",
        "description": "Email address of an identified visitor (from get_leads). When given, the list is the recordings for this email."
      }
    }
  }
}

On this page