> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attio

> Sync people both ways with Attio, log conversations on the Attio timeline, and send WhatsApp templates from Attio workflows and records.

The Attio integration keeps your contacts in step between Attio and Ciarem. Attio People become Ciarem contacts that templates, the AI and the Inbox can use. Conversations and template sends appear on the person's timeline in Attio, and your team can send WhatsApp templates from Attio workflows and from a person's record. Admins set it up under **Settings > Integrations > Attio**.

Ciarem works with one CRM at a time: you can connect HubSpot, Attio or [RD Station CRM](https://help.ciarem.ai/integrations/rdstation.md), only one of them. To switch, disconnect the one you have first.

## Plans

Attio is included on **Growth** and **Scale**, and during the free trial. It is not included on **Solo**. Solo can't be chosen while Attio is connected: disconnect it first, or pick Growth or Scale. See [Plans and billing](https://help.ciarem.ai/billing/plans-and-billing.md).

If your trial ends or your subscription stops, Attio stays connected but nothing syncs in either direction. Once you subscribe to Growth or Scale, syncing resumes on its own. A contact you edited in Ciarem while sync was stopped reaches Attio the next time it changes.

## Connect Attio

**1. Open the Attio integration**

Go to **Settings**, then **Integrations**, and click **Connect** on the Attio card.

**2. Approve access in Attio**

Sign in to Attio, choose your workspace, and approve access for Ciarem. This also installs the Ciarem app in your Attio workspace. Until the Ciarem app is listed in Attio's App Store, Attio shows a warning that the app hasn't been approved. Click **Allow** to continue.

**3. Finish setting up Attio**

Back in Ciarem, a three-step setup asks for your funnel stages, your attribute mapping and contact owner, and your import filters. Click **Finish** to save it and start the sync. Nothing syncs until you finish, so your choices apply from the very first person.

If you close the setup, the integration shows **Partially configured**. Click **Finish setup** to come back to it. After setup, change any of it on the **Funnel stages**, **Attribute mapping**, **Import filters** and **Tasks** tabs (and **Companies**, once it appears), then click **Save changes**.

### What Ciarem adds to Attio

Connecting adds one text attribute to People in Attio, **Ciarem contact ID**. Turning on [Companies](#companies) adds another to Companies, **Ciarem company ID**. Ciarem writes its own ID there to keep each Attio record linked to its contact or company in Ciarem, so don't edit or delete these attributes. Ciarem doesn't create, edit or delete any other attribute on People or Companies, or any status.

## While Attio is connected

Contacts are managed in Attio. The **Contacts** section is hidden in Ciarem, and template variables use the data synced from Attio. In the Inbox, a conversation's details panel shows the **Last Attio sync** and a **View in Attio** link.

## What syncs

* **People, both ways.** People sync here, and [companies](#companies) too once the add-on is on. Deals don't sync. A person in Attio is imported once they have a valid phone number with its country code. A contact created or edited in Ciarem is written to Attio (name, email, phone and Instagram) once Ciarem knows their name or email. A contact with only a phone number is not sent. If a person with the same email already exists in Attio, Ciarem links to that person instead of creating a new one. When Ciarem writes an email, Attio may create or link a company from the email's domain on its own. When a person has several email addresses or phone numbers, Ciarem uses the first email and the first valid phone. When Ciarem writes an email or phone to Attio, it adds it to the person's list and never removes the others.
* **Synced automatically.** Name, email, phone, city and Instagram sync on every person without any mapping.
* **Attribute mapping.** On the **Attribute mapping** tab, pick Attio attributes to bring into Ciarem contact properties, so templates and the AI can use them. Choose a Ciarem property for each, or **Create from Attio** to make a matching one. Mapped attributes sync from Attio to Ciarem. Every mapped property needs a **Description for the AI**: the AI learns from it what the property means and when to use it, so phrase it as an instruction.
* **Import filters.** On the **Import filters** tab, add conditions to choose which people are imported. Only people who meet every condition are added. With no filters, everyone with a valid phone number is imported. People already in Ciarem keep syncing.
* **Contact owner.** Under **Contact owner**, pick the Attio attribute that names the owner. The owner then syncs both ways, for teammates whose email is a member of your Attio workspace. Choose **Don't sync owners** to leave owners out.
* **Funnel stages.** On the **Funnel stages** tab, pick a status attribute on People in Attio. Its statuses become your stages in Ciarem. Attio owns the statuses and their order, so you add, rename or reorder them in Attio. Describe each stage so the AI knows when a contact belongs there. To let the AI move contacts into a stage, click the **AI off** button next to it (every stage but the first) and choose which agents may move contacts there and when. When the AI moves a contact in a real conversation, Ciarem writes the new status to the person in Attio. The Playground only shows the move; it doesn't write it. Until you pick an attribute, funnel stages are off.
* **Tasks, both ways.** **Sync tasks** (the **Tasks** tab) is on unless you turn it off. While it is on, a contact's [tasks](https://help.ciarem.ai/using-ciarem/tasks.md) and the person's tasks in Attio stay in step: title and note, due date and completion. Tasks Ciarem creates in Attio have no assignee, and priority and type don't sync. Attio can't edit a task's text, so changing a task's title or note in Ciarem replaces the task in Attio. Attio tasks are imported only when they're linked to a person synced with Ciarem.
* **Conversations on the timeline.** Conversations opened and resolved, and WhatsApp templates sent, appear on the person's Activity tab in Attio, with a link back to Ciarem. Attio groups them under **automation events** on the Activity tab: click it to expand them.

> [!NOTE]
>
> Timeline entries need Attio's custom activities feature. If your workspace doesn't have it, the Attio settings page shows **Timeline entries are off**, and entries appear once your workspace has it. Everything else syncs as usual.

### No status attribute yet?

People in Attio don't come with a status attribute. If you don't have one, the **Funnel stages** tab tells you. In Attio, open People, add an attribute of type Status (for example Lead stage) with your stages, then come back and pick it.

Switching to another attribute later replaces your stages with its statuses, places contacts again from their status in Attio, and removes the AI settings of the current stages.

## Companies

Companies sync with Attio too, once two things are in place:

1. **Turn on the Companies add-on** under **Settings > Add-ons**. See [Companies](https://help.ciarem.ai/using-ciarem/companies.md).
2. **Finish the Attio setup.** Nothing to reconnect: if Attio was already connected, companies start syncing on their own within a few minutes of the add-on being on (the **Companies** tab says so).

Attio is where your companies are managed. The **Companies** page stays hidden in Ciarem, as it does with HubSpot, but companies show on a contact's details panel in the Inbox, and the AI and message variables use them.

* **Companies and their fields.** Every Attio company is imported with its name and domain. The domain syncs both ways: a company you make in Ciarem is added to Attio, or linked to the Attio company that already has that domain.
* **Company attribute mapping.** On the **Companies** tab, under **Company attribute mapping**, pick Attio company attributes to bring into Ciarem company properties, so templates and the AI can use them. Choose a Ciarem property for each, or **Create from Attio** to make a matching one. Mapped attributes sync from Attio to Ciarem.
* **Company owner.** Under **Company owner**, pick the Attio company attribute that names the owner. Attio has no standard owner attribute for companies, so nothing is picked at first and owners are left out until you choose one. The owner then syncs both ways, for teammates whose email is a member of your Attio workspace.
* **A person's company.** The Company on a person in Attio is that contact's **primary company** in Ciarem, and the other way round: when you make another company primary in Ciarem, it becomes the person's Company in Attio. Attio holds one company per person, so any other companies you link to a contact stay in Ciarem only and are never sent to Attio. A company the AI linked reaches Attio only after a person confirms the link.
* **Companies from email domains.** Attio creates companies on its own from the domain of a person's email, and links the person to one when they have none. Those companies are imported into Ciarem like any other. This is Attio's own setting; to turn it off, go to **Settings > Workspace > Email and calendar > Record creation** in Attio. Turning it off removes nothing that already exists.
* **No automatic linking by domain.** While Attio is connected, Ciarem doesn't link contacts to companies by email domain, because Attio does it.
* **Deleting a company in Attio.** The company stays in Ciarem, with its contacts and its fields, and is no longer linked to Attio. A company that is still linked to Attio can't be deleted in Ciarem: delete it in Attio instead.

If a company's domain already belongs to another company in Ciarem, the domain is left as it was.

## Contacts not imported

Some people in Attio can't be created in Ciarem. Once setup is done, the Attio settings page lists them under **Contacts not imported**, each with the reason and an **Open in Attio** link so you can fix it there:

* **Phone already used**: another contact in Ciarem already has this phone number.
* **Email already used**: another contact in Ciarem already has this email.
* **Instagram already used**: another contact in Ciarem already has this Instagram username.
* **Invalid phone**: the person has no phone number Ciarem can use. Add one with its country code, for example +52.

Fix the person in Attio, for example by merging the duplicates or correcting the value, and they sync on their own.

## Send WhatsApp from Attio

The Ciarem app in your Attio workspace adds two ways to send an approved WhatsApp template. Both send through Ciarem, so the person must already be synced to a Ciarem contact. Attio shows these in English.

* **Workflow step.** In an Attio workflow, add the **Send WhatsApp template** step. Pick the **Person** (usually the one that triggered the workflow), the **WhatsApp line** and the **Template**. Only approved templates Ciarem can fill are listed. In **Variable values (JSON)**, give one value per template variable, as text or a `{{contact.…}}` reference Ciarem fills, for example `{"1": "{{contact.first_name}}"}`. If the template's variables have names, use the name as the key, for example `{"contact_first_name": "{{contact.first_name}}"}`. The step finishes as **Sent**, or with an error that says what went wrong.
* **From a person's record.** On a person in Attio, open the **More** menu (⋯), find the Ciarem app, and choose **Send WhatsApp template**. It is also in Attio's command menu (CMD+K). Pick a line and a template, fill in the variable values, and click **Send**.

## Merging people in Attio

When you merge two people in Attio, the merged person stays linked to Ciarem. If both were linked to different Ciarem contacts, the second contact is unlinked and keeps its conversations; it links again if it matches a person later.

## Deleting a person in Attio

Deleting a person in Attio unlinks them from Ciarem. The Ciarem contact and its conversations are kept.

## Reconnect

If the Ciarem app is removed in Attio, the integration shows **Needs reconnection**. Click **Reconnect** and approve access again. Choose the same workspace to keep your sync settings. Choosing a different workspace removes the setup and its contact links.

## Disconnect

**Disconnect** stops the sync and brings the Contacts section back in Ciarem. Your contacts, their conversations and your funnel stages stay in Ciarem. Your sync settings are cleared, so connecting again runs the setup again; choosing the same workspace keeps contacts linked to their people. Your data in Attio is not touched. The Ciarem app stays in your Attio workspace; to remove it too, uninstall it in Attio's settings.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.