# Linking Attio as a source - Docs

The Attio connector can link companies, people, deals, lists, users, workspaces, notes, tasks, and workspace members to PostHog.

To link Attio:

1.  Go to the [sources tab](https://app.posthog.com/data-management/sources) of the data pipeline section in PostHog.

2.  Click **\+ New source** and then click **Link** next to Attio.

3.  Next, you need an access token from Attio. Go to your [developer settings](https://attio.com/help/reference/integrations-automations/generating-an-api-key) in Attio and create a new access token with read permissions for the data you want to sync.

4.  Back in PostHog, paste the access token in the `Access token` field and click **Next**.

5.  On the next page, set up the schemas you want to sync and modify the method and frequency as needed. Once done, click **Import**.

Once the syncs are complete, you can start using Attio data in PostHog.

## Optional standard objects

The `users`, `workspaces`, and `deals` schemas are optional standard objects in Attio. They only exist in Attio workspaces that have enabled them.

If you try to sync one of these schemas and it isn't enabled in your Attio workspace, the sync fails with an error like:

> "Attio rejected the request for this object query. Please verify the schema is available in Attio and that the request is valid, then try again."

To fix this, either enable the object in your Attio workspace or disable syncing for that schema in PostHog.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| API key | password | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| companies | A company record in the Attio CRM. | Full refresh | — | — |
| people | A person record in the Attio CRM. | Full refresh | — | — |
| deals | A deal record in the Attio CRM, tracking a sales opportunity. | Full refresh | — | — |
| users | A user record in the Attio CRM, representing a product user. | Full refresh | — | — |
| workspaces | A workspace record in the Attio CRM, representing a customer account or workspace. | Full refresh | — | — |
| lists | A list in Attio, used to track records through a pipeline or collection. | Full refresh | — | — |
| notes | A note attached to a record in Attio. | Full refresh | — | — |
| tasks | A task in Attio, optionally linked to records and assignees. | Full refresh | — | — |
| workspace_members | A member of the Attio workspace. | Full refresh | — | — |

### Community questions

Ask a question

### Was this page useful?

HelpfulCould be better