# Tag leads from your code (/docs/leads/tags/api)

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

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

<ApiPlayground
  ops={["GET /v3/tags", "POST /v3/tags", "POST /v3/leads/{leadId}/tags/{tagId}", "DELETE /v3/leads/{leadId}/tags/{tagId}", "PUT /v3/tags/{tagId}", "DELETE /v3/tags/{tagId}"]}
  method="get"
  path="/v3/tags"
  tool="list_tags"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}`}
/>

## Use case: Tag a lead from your CRM sync [#use-case-tag-a-lead-from-your-crm-sync]

Create the tag once with `POST /v3/tags`, then `POST /v3/leads/{leadId}/tags/{tagId}` for each lead.