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

# Attio

> Push enriched data from your warehouse into Attio

## Supported syncing

| Type | Description | Supported Sync Modes | API Reference |
| - | - | - | - |
| **Companies** | Sync data from any source to companies in Attio | Upsert | [Companies docs](https://developers.attio.com/reference/put_v2-objects-companies-records) |
| **Custom objects** | Sync data from any source to custom objects in Attio | Upsert | [Custom objects docs](https://attio.com/developers/rest/record#assert-a-record) |
| **Deals** | Sync data from any source to deal objects in Attio | Upsert | [Deal docs](https://developers.attio.com/reference/put_v2-objects-deals-records) |
| **People** | Sync data from any source to people in Attio | Upsert | [People docs](https://developers.attio.com/reference/put_v2-objects-people-records) |
| **Users** | Sync data from any source to user objects in Attio | Upsert | [User docs](https://developers.attio.com/reference/put_v2-objects-users-records) |
| **Workspaces** | Sync data from any source to workspace objects in Attio | Upsert | [Workspace docs](https://developers.attio.com/reference/put_v2-objects-workspaces-records) |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Attio

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Attio** and click **Continue**.

You will be required to enter your Attio API key. You can locate this API key within your Attio account by navigating to Workspace Settings > Developers:

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-attio-setup.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=eee1209248b673f1a1cf48f988f8a50d)

## Sync configuration

Hightouch supports syncing to the following Attio objects:

* `Companies`
* `Custom objects`
* `Deals`
* `People`
* `Users`
* `Workspaces`

### Sync modes

Hightouch supports the following sync modes:

* **Upsert** - pushes new objects to Attio and updates fields that change in your warehouse.

### Record matching

Depending on the object you are syncing, records can be matched from your source to your Attio workspace by `domains` for companies, `email_addresses` for people, or other read-only fields for custom objects.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-attio-idfieldmapping.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=62de3ba8817764193b598974acf97e96)

### Field mapping

You may also sync columns from your source to Attio's object properties.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-attio-fieldmappings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=70d8ca454b6ee764db7f79440f57daaa)

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).
