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

# Attio

> Let Stella look up people, companies, deals and notes in Attio.

## What it does

Attio connects as a **connector**: Stella, your AI teammate, can look things up in your Attio workspace when you ask. "What did we last note about Hooli?", "Which deals with Raviga are still open?" and "Who owns the Pied Piper account in Attio?" are all answered from Attio itself.

Attio connects **per person**. Each teammate signs in with their own Attio account, and Stella sees only the people, companies, deals and notes that person can see in Attio. Nothing is copied into Custral: Stella reads Attio at the moment you ask.

## Connect

**1. Find Attio**

Go to **Settings → AI and automations → Connectors** and find **Attio** under **Browse**. It also appears as a card
on **Settings → Integrations**, badged **Each person · for Stella**.

**2. Sign in to Attio**

Choose **Connect**. Attio's own consent screen opens. Approve it and you come back to Custral with Attio listed
under **Connected**.

**3. Ask Stella**

Stella can use Attio on your next message. To point it at Attio on purpose, type `/` in Stella and pick
**Attio**.

## Configure

Choose **Configure** on the connected row:

| Setting | What it does |
| - | - |
| **On** | Turn off to hide Attio's tools from Stella without disconnecting. |
| **Let Stella use write tools** | Off by default, so Attio starts read-only. When on, Stella can use tools that change data in Attio, and asks you before every one. Tools Attio marks destructive are never used. |
| **Tools** | Every tool Attio offers, marked *Read*, *Changes data* or *Destructive*. Turn off any you don't want Stella to use. |
| **Inbound events** | A URL you can set up in Attio to post events to. Each post fires the **Connector Event Received** workflow trigger. The URL holds its own secret, so it's shown once. |

## Resources synced

Nothing is synced. Attio stays the record of its own data.

| Attio resource | Custral surface |
| - | - |
| People, companies, deals and notes | Read by Stella when you ask, through Attio's own tools |
| Events Attio posts to the inbound URL | The **Connector Event Received** workflow trigger |

## Limitations

* Stella sees only what your Attio account can. A teammate who hasn't connected Attio gets no Attio answers, even if you have.
* Write tools are off until you turn them on, and every write asks first.
* Once Stella has read from Attio in a chat, it asks before writing anything back into Custral (a record, a note, a task), because anyone who can open that record would see what it read.
* Attio records don't become Custral records. To bring CRM data into your own objects, export it from Attio and [import the file](https://docs.custral.com/data/records/import.md).

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| "Connection cancelled" | Access wasn't granted on Attio's consent screen. | Choose **Connect** again and approve. |
| "Connection expired" | The sign-in took too long or was already finished. | Start the connection again from **Connectors**. |
| "Couldn't connect the server" | Attio didn't accept the connection. | Start connecting it again from **Settings → AI and automations → Connectors**. |
| The row says **Needs attention** | The last call to Attio failed. | Open **Configure** and reconnect to restore Stella's access. |
| The row says **Off** | The connector is switched off. | Turn **On** back on in **Configure**. |
| Stella won't change anything in Attio | **Let Stella use write tools** is off, or that tool is turned off. | Turn write tools on, and check the tool's switch under **Tools**. |

## Disconnect

Open **Configure** and choose **Disconnect**. Stella loses access to Attio's tools until you connect it again. It only removes your own connection; teammates' connections stay.

## Related

* [Connectors](https://docs.custral.com/ai/mcp-connections.md): how connectors work, and adding your own.
* [Workflow triggers](https://docs.custral.com/automation/workflows/triggers.md): **Connector Event Received**.
* [Importing records](https://docs.custral.com/data/records/import.md): bringing CRM data into your own objects.
* [Integrations overview](https://docs.custral.com/integrations/overview.md)


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