# Notes on leads

> Write notes on a lead that your whole team can see.

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/comments

Notes keep your team on the same page: what was said, what happens next.

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

1. **Open a lead.**
2. **Notes → write → Save note.**
3. Everyone on your team sees it on that lead.


---

## API — From your code

Source: /docs/leads/comments/api

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

<Endpoints ops={["GET /v3/leads/{leadId}/comments", "POST /v3/leads/{leadId}/comments", "PUT /v3/comments/{commentId}", "DELETE /v3/comments/{commentId}"]} />

<ApiPlayground
  ops={["GET /v3/leads/{leadId}/comments", "POST /v3/leads/{leadId}/comments", "PUT /v3/comments/{commentId}", "DELETE /v3/comments/{commentId}"]}
  method="get"
  path="/v3/leads/{leadId}/comments"
  tool="get_lead_comments"
  args={`{
  "leadId": ""
}`}
/>

### Use case: Log a call from your phone system [#use-case-log-a-call-from-your-phone-system]

`POST /v3/leads/{leadId}/comments` with `{ "content": "Called, interested, follow up Friday" }`.


---

## MCP — AI agents

Source: /docs/leads/comments/mcp

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

<Tools names={["get_lead_comments", "add_lead_comment", "update_lead_comment", "delete_lead_comment"]} />

### Use case [#use-case]

> Add a note to this lead: called them, follow up on Friday.

<McpToolCall name="add_lead_comment">

```json
{
  "leadId": "6530c1d2e3f4a5b6c7d8e9f2",
  "content": "Called them, follow up on Friday."
}
```

</McpToolCall>