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

# Attio

> Sync identified visitors and companies to your Attio workspace

# Attio integration

The Attio integration automatically syncs the people and companies that Maverick Intelligence identifies on your website into your Attio workspace. New visitors become people records, their employers become company records, and the two are linked together — all without you lifting a finger.

The sync is **non-destructive**: Maverick only ever fills in missing fields. It never overwrites data that already exists on your Attio records, so it's safe to run alongside your existing data and other integrations.

## How it works

Once connected, Maverick watches for visitors identified on your site and pushes them to Attio in near real time:

* **People** are matched to your Attio workspace by email address. If a person with that email already exists, Maverick fills in any blank fields. If they don't exist, a new person record is created.
* **Companies** are matched by domain. The same create-or-fill logic applies.
* **Association** — when a person and their company are both synced, Maverick links the person to the company using Attio's company reference, so your records stay connected.
* **Enrichment** — as Maverick enriches a visitor with additional detail (such as a job title or LinkedIn profile), those new fields are pushed to Attio too, again only filling gaps.

<Note>
  A person is only synced once Maverick has resolved an email address for them, because email is how records are matched in Attio. Anonymous visitors with no email are not synced as people — but their company can still be synced if company sync is enabled.
</Note>

## What gets synced

### People

| Maverick field      | Attio attribute |
| ------------------- | --------------- |
| Email               | Email addresses |
| First and last name | Name            |
| Job title           | Job title       |
| Phone               | Phone numbers   |
| LinkedIn URL        | LinkedIn        |

### Companies

| Maverick field | Attio attribute |
| -------------- | --------------- |
| Company name   | Name            |
| Domain         | Domains         |
| LinkedIn URL   | LinkedIn        |

Maverick maps to Attio's standard people and companies attributes. Fields without a standard Attio equivalent (such as industry, employee count, and location) are not synced.

## Connect Attio

<Steps>
  <Step title="Open Integrations">
    Log in to your [Maverick Intelligence dashboard](https://app.maverickintelligence.co) and open **Integrations** from the sidebar.
  </Step>

  <Step title="Connect Attio">
    Find the **Attio** card and click **Connect**. You'll be redirected to Attio to authorize access to your workspace.
  </Step>

  <Step title="Authorize access">
    Review the requested permissions in Attio and approve them. Attio sends you back to Maverick, where the Attio settings open automatically.
  </Step>

  <Step title="Add a workspace access token (recommended)">
    To keep the connection permanent, add a workspace access token. See [Recommended: add a workspace access token](#recommended-add-a-workspace-access-token) below.
  </Step>
</Steps>

## Recommended: add a workspace access token

Attio's authorization tokens from the connect flow expire after one hour and cannot be automatically renewed. For a connection that never expires, add a **workspace access token** from your Attio workspace. This is the recommended way to run the integration.

<Steps>
  <Step title="Create the token in Attio">
    In Attio, go to **Settings → Developer → Access tokens** and click **Create access token**.
  </Step>

  <Step title="Grant the scopes">
    Enable **Records** (Read/Write) and **Object configuration** (Read).
  </Step>

  <Step title="Paste it into Maverick">
    Copy the token, return to the Attio settings in Maverick, paste it into the **Workspace Access Token** field, and click **Save**.
  </Step>
</Steps>

Once a workspace token is saved, the connection status shows **Connected** and syncing runs indefinitely.

## Configure what syncs

The Attio settings have separate controls for people and companies.

### People

Choose how visitors sync under **People Sync**:

* **Off** — don't sync people.
* **All visitors** — sync every identified visitor who has an email address.
* **Hot leads only** — sync only visitors that match your hot-lead criteria.

### Companies

Toggle **Sync Companies** to add the companies behind your visitors to Attio. With this on, a visitor's company can be synced even when the visitor themselves can't be (for example, an anonymous visitor with no email).

## How records are matched and updated

Maverick uses Attio's assert endpoints to create-or-find records:

* People are matched on **email addresses**.
* Companies are matched on **domains**.

When a match is found, Maverick checks each field and sends only the ones that are currently empty. Existing values are always left untouched, so the integration is safe to run continuously and alongside other tools writing to the same workspace.

## Permissions

Maverick requests the minimum scopes needed to sync your data:

| Scope                       | Why it's needed                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| Records (read and write)    | Create people and companies, and fill in missing fields on existing records               |
| Object configuration (read) | Read your workspace's attribute configuration so values are written in the correct format |

## Disconnecting

To stop syncing, open **Integrations** in the Maverick dashboard, find the **Attio** card, and click **Disconnect**. Syncing stops immediately. Records already synced to Attio remain in your workspace. You can reconnect at any time.