Tag records
Adds and removes tags on up to 100 contacts, companies or deals at once.
$0.001 per record tagged
From your agent’s balance. A call that fails costs nothing.
An example
Tag Sophie Lange and Emma Fischer as autumn sale 2026 buyers, and take the cold tag off them.
Your agent callscrm_tag_records$0.001 per record tagged
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"object": "contact",
"ids": [
4812,
4815
],
"add": [
"autumn-sale-2026"
],
"remove": [
"cold"
]
}Use it when
A group of records gets or loses a label: everyone who came to an event, all autumn buyers.
- For one contact with other changes as well, use
crm_update_contact.
What it does
Add and remove tags on up to 100 contacts, companies or deals at once, such as everyone who came to a webinar. A new tag is made on first use; tags match in any case. Find tagged records with the tag argument of the find tools.
What comes back
tagged: how many records changed, missing_ids: ids that are not records of the business, and the tags added and removed. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
objectRequired | string | One of: contact,company,deal. |
idsRequired | array of integers | 1 to 100 items. |
add | array of strings | Up to 20 items. |
remove | array of strings | Up to 20 items. |
The call
Over MCP, call crm_tag_records on https://api.conecto.chat/mcp/crm. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/crm_tag_records \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"object":"contact","ids":[4812,4815],"add":["autumn-sale-2026"],"remove":["cold"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | No tag to add or remove was given. | Send add, remove or both. |
not_found404 | None of the ids is a record of the business. | Find the records with crm_search or the find tools and use their ids. |
More CRM tools
All 41 tools- Search the CRM
crm_searchFinds contacts, companies and deals from whatever you have: a name, an email, a phone number in any format, a domain or a deal title.Free* - Find contacts
crm_find_contactsFinds contacts by name, email, company or phone, by filters on any field or tag, or by a saved segment, one page at a time.Free* - Get a contact
crm_get_contactOne contact, by id or email, with its tags, custom fields, recent activity, open tasks and deals.Free* - Everything open with a customer
crm_get_customerEverything open with one customer in one read: deals, tickets, invoices, quotes, signatures, meetings and their last messages.Free* - Save a contact
crm_save_contactCreates a contact, or updates the one with the same email; only the fields you send change.$0.01 a call - Save many contacts
crm_save_contactsCreates or updates up to 100 contacts in one call, each like crm_save_contact; you pay only for the ones saved.$0.01 per record saved - Update a contact
crm_update_contactChanges fields on a contact by its id, its email included; only the fields you send change.$0.01 a call - Archive a contact
crm_archive_contactHides a contact from searches and lists; its history is kept.$0.001 a call
Read next: The best AI agents for small business in 2026, The best MCP servers for small business in 2026, What is an MCP server?
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md