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

# Attio integration

> Set up the Attio Cometly integration so new and updated people, users and deals arrive as events tied to the ads and channels that produced them.

The Attio Cometly integration sends records from your Attio CRM to Cometly. When a record (a person, user or deal) is created or updated in Attio, Cometly receives it as an event: a conversion, such as a lead or a closed deal, that Cometly ties back to the ad or marketing channel the contact came from.

This matters because the outcome of a lead usually lives in your CRM, not on your website. With Attio connected, you can see which ads and channels generate pipeline and revenue, not only form fills, and decide where to spend based on the deals they produce.

The Cometly app is listed publicly in Attio under **Apps & Integrations**:

![Cometly app listing in Attio Apps and Integrations, About tab, showing the overview and how it works](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/attio/01.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=46e618e1bb45f3a57e0b14af0195bf0c)

## Step 1: Create the event in Cometly

1. In Cometly, click **Events Manager** in the sidebar.
2. Click **Create Event**.
3. Under **App / Integration**, select **Attio**.
4. Select the event name (for example **Lead**), or click **Create New Event** to add your own.
5. Click **Create**.

![The Create Event dialog in Cometly with numbered markers on the App / Integration field set to Attio (1), the Events field set to Lead (2) and the Create button (3).](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/attio/05.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=932487f0adee03ea7a6217cf4db6ef17)

The event appears in the Events Manager with the status **Draft**. Click **Configure** on that row to continue.

## Step 2: Select your Attio account

On the **Configure Integration** page, the **App** field is already set to Attio.

1. Open the **Account** dropdown.
2. Pick a connected Attio account. Accounts are listed by the email address of the Attio user who connected them (for example `name@youremail.com`).
3. If you have not connected Attio yet, click **Connect new account** and approve access in Attio.

If you have more than one Attio account connected, choose the one this event should come from.

![The Attio event setup form in Cometly with the Account dropdown open, and an arrow pointing to Connect new account above a connected account whose email is blurred.](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/attio/02.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=ba0c989a587c84653f3285bdb15c1940)

## Step 3: Select the Attio object

Under **Object**, choose which Attio object should fire the event. Examples include:

* **Person**
* **User**
* **Deal**

Select the object that represents the action you want to track in Cometly.

## Step 4: Choose a trigger

Under **Trigger**, choose when Cometly should capture the event from Attio. There are two options:

| Trigger | When it fires | Examples |
| - | - | - |
| **Record Created** | A new record is created in Attio | A new person, user or deal |
| **Record Updated** | Values on an existing record are updated | A deal stage changes, a status is updated |

![The Attio event setup form in Cometly with the Trigger dropdown open, showing the Record Created and Record Updated options with their descriptions.](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/attio/03.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=3c6923d51bf1ced89944f9a11d0e1f06)

If you choose **Record Updated**, an **Attribute** field appears. Select the attribute whose changes should trigger the event. The event only fires when that attribute changes.

When the account, object and trigger are selected, click **Continue**.

> [!WARNING]
>
> Once selected, the **Account** and **Trigger** cannot be modified. To change them later, you need to create a new event.

## Step 5: Receive a sample record

Cometly needs one real record from Attio to build the field mapping.

1. On the **Receive Data** step, click **Check for Data**.
2. While the page is open, trigger the event in Attio (for example, create a test record or update the attribute you selected). Samples are only collected for a few minutes after the page loads.
3. Select the record that appears and click **Continue With Selected Record**.

If nothing arrives yet, click **Save & Return When Data is Ready** and come back to the event later.

## Step 6: Map Attio fields to Cometly fields

On the **Configure Mapping** step, map the Attio data to Cometly fields such as:

* **Email** (required)
* **Event Time** (required). If the record has no usable timestamp, choose **The time we receive the event** under **Dynamic Data**.
* **First Name**
* **Last Name**
* **Phone**
* Any other optional fields you want to track (click **Add Field**)

Click **Save & Continue**.

## Step 7: Configure filters (optional)

Filters control which events get processed. Only events that pass all filters are tracked in Cometly.

Examples:

* Only process person records where the email contains `@company.com`
* Only process deal updates where the stage is Closed Won

Filters help keep tracking clean and accurate, especially for large Attio workspaces.

## Step 8: Activate your event

Click **Activate**.

Your Attio integration is now active, and Cometly receives an event every time the chosen trigger fires.

> [!TIP]
>
> If you track deals, set up separate events for each stage of your pipeline, for example:
>
> * Deal Created
> * Deal Stage Updated
> * Closed Won
>
> This gives you complete pipeline attribution inside Cometly.

## Check it worked

In **Events Manager**, the event's row now shows the status **Active**. Trigger the event once more in Attio, then open the **Events Log** tab: the new event is listed there, and the row's **Total Events** count goes up.

## Manage your Attio connections

To add, resync or remove an Attio connection, or to share it with another space, go to **Integrations** and open the **Attio** card. Click **Add connection** to connect another Attio account.

## Frequently asked questions

### How do I track an Attio deal in Cometly when the deal has no email address?

Cometly needs an email to match the event to a contact. When a deal record is linked to people in Attio, Cometly also receives those people's details with the deal, so you can map the associated person's email to **Email** on the **Configure Mapping** step.

### Why is my Attio test record not showing up in Cometly?

Samples are only collected for a few minutes after the **Receive Data** page loads, so a record created later is not picked up. Click **Check for Data** again, then create or update the record in Attio. The record also has to match the object you selected and, for **Record Updated**, change the attribute you selected.

### Does the Attio integration import my existing Attio records?

No. The triggers fire when a record is created or updated in Attio, so Cometly receives events from the moment your event is active. Records that already existed arrive only if they are updated later and you use the **Record Updated** trigger.

## Next steps

* [Check incoming events in the Events Log](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Learn how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)
* [Manage your custom events](https://docs.cometly.com/guides/events/custom-events.md)
* [Send your Attio conversions back to your ad platforms with the Conversion API](https://docs.cometly.com/guides/conversion-api/overview.md)
* [Browse all Cometly integrations](https://docs.cometly.com/integrations/overview.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


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