# Session recordings

> Replay what a lead did on your website, page by page.

Every section below does the same job: in the dashboard (Guide), from your code (API) or through an AI assistant (MCP).

## Guide — In the dashboard

Source: /docs/leads/session-recordings

Every page a lead saw has a ▶: replay the visit to see what caught their attention.

<DemoFrame guide="leads-session-recordings" to="/identify/{workspace}?tab=visitors" />

1. **Open a lead** from Website Visitors.
2. **▶ on a page** replays that visit.
3. **Pick a session** when they came back several times.

### Every control on this screen [#every-control-on-this-screen]

Every button, field and switch, with what it does.

<ScreenControls screens={["leads-recording", "session-player"]} />


---

## API — From your code

Source: /docs/leads/session-recordings/api

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["GET /v3/recordings", "GET /v3/recordings/{sessionId}/url", "PUT /v3/websites/{websiteId}/session-recording"]} />

<ApiPlayground
  ops={["GET /v3/recordings", "GET /v3/recordings/{sessionId}/url", "PUT /v3/websites/{websiteId}/session-recording"]}
  method="get"
  path="/v3/recordings"
  tool="get_lead_recordings"
  args={`{
  "email": "ava.thompson@northwind-analytics.example"
}`}
/>

### Use case: Link a replay in your CRM [#use-case-link-a-replay-in-your-crm]

`GET /v3/recordings?email=…` lists the sessions of a lead; `GET /v3/recordings/{sessionId}/url?clientId=…` returns a link to watch one.


---

## MCP — AI agents

Source: /docs/leads/session-recordings/mcp

Connect the [MCP server](/docs/mcp#quickstart), then just ask.

<Tools names={["get_lead_recordings", "get_recording_url", "set_session_recording"]} />

### Use case [#use-case]

> What did ava.thompson@northwind-analytics.example look at on our site?

<McpToolCall name="get_lead_recordings">

```json
{
  "email": "ava.thompson@northwind-analytics.example"
}
```

</McpToolCall>