[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Tag contacts

> Add a Privy tag to contacts, or remove it from them. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/privy/tag_contacts

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Add a Privy tag to contacts, or remove it from them.

Privy API: https://cotlet.dev/docs/api/privy.md

`POST https://cotlet.dev/api/v1/privy/contacts/tag`

Access: write. Confirm: waits for the user's OK before it runs.

Does what Bulk Actions > Tag Contacts does. A tag can start a flow set to Contact Tagged or Contact Untagged, and that flow can email or text those contacts, which is why this call waits for you. Tag-triggered flows fire only when the tag changes. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `tag` | string | yes | Tag name. Privy saves bulk tag names in lowercase |
| `action` | string | yes | add or remove |
| `contact_ids` | array | yes | Contact ids from list_contacts |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/privy/contacts/tag \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag":"tag","action":"action","contact_ids":"contact ids"}'
```

**Python**

```python
result = client.call("privy", "tag_contacts", {"tag":"tag","action":"action","contact_ids":"contact ids"})
```

**Node.js**

```js
const result = await cotlet.call('privy', 'tag_contacts', {"tag":"tag","action":"action","contact_ids":"contact ids"});
```

**CLI**

```bash
cotlet call privy tag_contacts --data '{"tag":"tag","action":"action","contact_ids":"contact ids"}'
```

## Example response

```json
{
  "tag": "sunset",
  "action": "add",
  "tagged": 2,
  "contacts": [
    "cus_91f2",
    "cus_a4c7"
  ]
}
```

Previous: [Launch a paused display](https://cotlet.dev/docs/api/privy/launch_display.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.