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

# Connect your app to Attio

> Connect your app to Attio to read and update CRM records, manage list entries, and create notes and tasks for sales and customer workflows.

[Attio](https://attio.com/) is a customer relationship management (CRM) platform for organizing people, companies, and deals. The Attio connector lets your Lovable app read and update CRM records and create notes and tasks.

Choose the connection type based on whose Attio workspace your app uses.

| Use | If you want to |
| - | - |
| [App + chat connector](https://docs.lovable.dev/integrations/app-connectors.md) (this page) | Work with a shared Attio connection in [Chats](https://docs.lovable.dev/features/chats.md), in the project chat, and in your published apps |
| [App user connector](https://docs.lovable.dev/integrations/app-user-connectors.md) | Let each signed-in user of your published app connect their own Attio workspace |

With Attio, your app can:

* Search and filter people, companies, deals, and other records in your Attio workspace
* Create records and update existing records
* Read lists, which group records for a process such as sales follow-up, and add records to them
* Add notes and create tasks linked to records

## Common use cases and example apps

These examples show what you can build with Attio, each with a prompt to start from.

| Example app | Example prompt | Description |
| :- | :- | :- |
| Lead intake form | *Use Attio and build a lead intake form that saves each submission as a person, updating the existing record when the email address matches.* | **Keep new inquiries in your CRM.** The app creates or updates people in Attio using the submitted contact details. |
| Company directory | *Use Attio and build an internal company directory where our support team can search companies and view their CRM details.* | **Give support teams access to company details.** The app queries company records and shows the fields your team needs before responding to customers. |
| Deal dashboard | *Use Attio and build a sales dashboard that groups deals by stage and lets our team update deal details.* | **Review and update your sales pipeline.** The app reads deal records and saves changes to their fields in Attio. |
| Event follow-up list | *Use Attio and build an event follow-up tool that finds people by email and adds them to our existing event list.* | **Organize contacts for follow-up.** The app finds matching people and adds entries to the Attio list you choose. |
| Company handoff tool | *Use Attio and build a company handoff tool that saves a note on a company record and creates a follow-up task for the assigned teammate.* | **Keep handoff details attached to the company record.** The app creates a record-linked note and a task with an assignee and deadline. |

## How to connect Attio

Who can create Attio connections depends on your plan and workspace settings. App + chat connectors are available by default. On Business and Enterprise plans, [Who can create connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-create-connections-and-clients) starts at **Admins**.

Some Enterprise workspaces start at **No one**, which disables the connector. An admin or owner changes it in **Connectors → Admin settings → App + chat connectors**.

You can create multiple Attio connections to work with different Attio workspaces.

When the connection is created, you can [link it to the projects](https://docs.lovable.dev/integrations/app-connectors.md#link-a-connection-to-a-project) where you want to use it. Anyone building in a project can ask Lovable in the project chat to link their project to it. Linking follows the connection's access rules.

### Prerequisites

Before connecting Attio, make sure you have:

* An Attio workspace where you are an admin. Click your workspace name in Attio and check that the menu shows **Workspace settings**.
* Permission to **create connections** in your Lovable workspace (see [Who can create connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-create-connections-and-clients))

### Set up your Attio connection

Sign in with your Attio admin account to authorize Lovable.

**1. Open Attio in Connectors**

Open [Connectors](https://lovable.dev/dashboard?connectors) and select **Attio**. For the other places to open the catalog from, see [Where to find connectors](https://docs.lovable.dev/integrations/introduction#where-to-find-connectors).

**2. Add a connection**

Click **Connect** on the connector page. The form has two collapsible sections: **Details** and **Sharing**.

**3. Name the connection**

Under **Details**, Lovable fills in a name for the connection, which you can change. The name is only used inside Lovable to identify the connection.

**4. Choose who can use this connection**

Under **Sharing**, the connection is private to you by default and shows a **Private** label. To share it, click **Share with others**. Then add workspace members by email, or click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

See [Who can use connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-use-connections-and-clients) for more information.

**5. Connect to Attio and authorize**

Click **Connect** at the bottom of the form. The Attio authorization window opens, so make sure your browser doesn't block pop-ups. If it does, Lovable redirects you instead.

Sign in to Attio if prompted, review the requested permissions, and authorize the app.

Lovable shows a confirmation when authorization succeeds.

When connected, anyone building in a project can ask Lovable in the project chat to link their project to Attio. Linking follows the connection's access rules. Your Lovable apps can then read and update your Attio CRM data.

## Working with Attio data

When prompting Lovable, name the records, lists, and fields your app needs. Specify whether the app should only display data or also save changes to Attio. For example, ask for a company directory that reads existing fields, or an intake form that updates people by email address.

Attio applies [API rate limits](https://docs.attio.com/rest-api/guides/rate-limiting) to requests from your app. For scheduled imports or dashboards with frequent updates, ask Lovable to reuse recent results. Ask Lovable to wait and retry when Attio asks the app to slow down.

## Limitations

The Attio app + chat connector documented on this page does not support a separate Attio login for each person using your app. All projects linked to a connection use the same Attio workspace and the connection's permissions, regardless of who uses the apps.

If you revoke Lovable's authorization in Attio, reconnect in Lovable before using the connection again.

> [!NOTE]
>
> To let each app user connect their own Attio workspace, use the Attio [app user connector](https://docs.lovable.dev/integrations/app-user-connectors.md#set-up-an-app-user-connector).
>
> You configure an [Attio OAuth app](https://docs.attio.com/rest-api/tutorials/connect-an-app-through-oauth) and add its client ID and client secret in Lovable. Each person connecting must be an admin of the Attio workspace they authorize.

## Manage your Attio connection

Connections are managed from [**Connectors**](https://lovable.dev/dashboard?connectors): select **Attio**, then open the connection.

* **Unlink projects** to remove Attio access from specific projects while keeping the connection available for others. See [Unlink projects from a connection](https://docs.lovable.dev/integrations/app-connectors.md#unlink-projects-from-a-connection) for the steps.
* **Delete the connection** to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use Attio stop working until a new connection is added. See [Delete a connection](https://docs.lovable.dev/integrations/app-connectors.md#delete-a-connection) for the steps and who can delete.
