Native tools (II): update contact and tags

Teach your AI agent to write data into the contact profile, tag contacts and move lifecycle stages, all without human intervention.

Jun 26, 2026

Watch this step in the video · Contact, tags and CRM

Your AI agent doesn't just chat: it can write into your CRM while it talks to the customer. These two native tools keep your data clean and segmented without anyone typing it by hand.

What each tool does

  • Update contact fields: saves what the customer mentions (name, email, city, company, job title, notes and your custom fields) into their profile. It only writes safe fields; it never touches system columns.
  • Update tags: adds or removes tags on the contact. If a tag doesn't exist it's created on the fly, and adding it fires any workflows listening for that event.

Before you start

  • Have your agent created under AI Agents (side menu).
  • Define in the prompt which values to save and which tags to use, so the agent doesn't improvise.

Steps to enable them

  1. Open your agent from AI Agents (side menu).
  2. Go to the Custom actions tab.
  3. Under Native tools, turn on Update contact fields and/or Update tags depending on what that agent needs.
  4. For each tool, write the usage instructions: when to save a value and which tag to apply. For example: "If the customer gives their email, save it. If they show interest, add the hot-lead tag."
  5. Save your changes.

How to verify it works

  1. Open the agent's Sandbox tester.
  2. Run a chat where the customer shares their email and shows interest.
  3. Check the contact profile: the email should be there and the tag added.

If it doesn't work

  • The value isn't saved: confirm the field is on the allowed list (names like email, city, company are; internal columns are not) and that your instructions ask the agent to save it.
  • The tag isn't showing in reports: remember it's auto-created; make sure a typo didn't spawn a brand-new tag by mistake.

Tips

Pair Update tags with a workflow: adding the "customer" tag can automatically trigger a welcome message or a task for Sales.

Start with a few well-defined tags. An AI that tags with judgment is gold for segmenting your broadcasts.

Note: moving a contact between lifecycle stages is no longer an agent tool; that flow is handled from the CRM and its pipelines.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp