> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trywildcard.ai/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 Wildcard 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**: Wildcard 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, Wildcard 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, Wildcard 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, Wildcard links the person to the company using Attio's company reference, so your records stay connected.
* **Enrichment** — as Wildcard 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 Wildcard 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.

## What gets synced

### People

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

### Companies

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

Wildcard 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

**1. Open Integrations**

Log in to your [Wildcard dashboard](https://app.maverickintelligence.co) and open **Integrations** from the sidebar.

**2. Connect Attio**

Find the **Attio** card and click **Connect**. You'll be redirected to Attio to authorize access to your workspace.

**3. Authorize access**

Review the requested permissions in Attio and approve them. Attio sends you back to Wildcard, where the Attio settings open automatically.

**4. 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.

## 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.

**1. Create the token in Attio**

In Attio, go to **Settings → Developer → Access tokens** and click **Create access token**.

**2. Grant the scopes**

Enable **Records** (Read/Write) and **Object configuration** (Read).

**3. Paste it into Wildcard**

Copy the token, return to the Attio settings in Wildcard, paste it into the **Workspace Access Token** field, and click **Save**.

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

Wildcard 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, Wildcard 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

Wildcard 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 Wildcard 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.


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