Add contact tags

Adds tags to one or more contacts.

POST https://cotlet.dev/api/v1/agile-crm/contact-tags

write

Adds the tags to every contact in the list and returns each contact's tags afterwards. Tags reach nobody and a wrong tag is removed from Agile CRM by hand, so the call does not wait for your OK. A tag name Agile CRM rejects fails before any contact changes.

Parameters

Parameters: add_contact_tags
NameTypeDescription
contact_ids array required array Contact ids from list_contacts
tags array required array Tag names to add; a tag starts with a letter and holds letters, numbers, underscores and spaces

Request

cURL
curl -X POST https://cotlet.dev/api/v1/agile-crm/contact-tags \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_ids":"contact ids","tags":"tags"}'
Python
result = client.call("agile-crm", "add_contact_tags", {"contact_ids":"contact ids","tags":"tags"})
Node.js
const result = await cotlet.call('agile-crm', 'add_contact_tags', {"contact_ids":"contact ids","tags":"tags"});
CLI
cotlet call agile-crm add_contact_tags --data '{"contact_ids":"contact ids","tags":"tags"}'

Example response

JSON

{
  "updated": [
    {
      "contact_id": "5698320417841152",
      "tags": [
        "webinar_oct",
        "lead",
        "nurture"
      ]
    },
    {
      "contact_id": "5701182246576128",
      "tags": [
        "webinar_oct",
        "nurture"
      ]
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.