Tag contacts
Add a Privy tag to contacts, or remove it from them.
MCP tool privy_write → tag_contacts
write Confirm
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 | Description |
|---|---|---|
| tag string required | string | Tag name. Privy saves bulk tag names in lowercase |
| action string required | string | add or remove |
| contact_ids array required | array | Contact ids from list_contacts |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "privy_write",
"arguments": {
"operation": "tag_contacts",
"arguments": {
"tag": "tag",
"action": "action",
"contact_ids": "contact ids"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"tag": "sunset",
"action": "add",
"tagged": 2,
"contacts": [
"cus_91f2",
"cus_a4c7"
]
},
"isError": false
}