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

# Attio

## Introduction

Qobra connects to Attio through an application, which needs to be installed via
an Oauth check.

The integration is used to synchronize your Attio data, both **Objects**
(standard and custom) and **Lists**, with their fields and their content. This
integration is readonly and does not write anything in your Attio workspace.

## Access

### Oauth authentication & scopes

To connect your Attio to Qobra, you'll need to go through an Oauth flow,
granting us access to several read-only scopes:

* `record_permission:read` (Read the content of your records)
* `object_configuration:read` (Read objects and their attributes)
* `list_configuration:read` (Read lists and their attributes)
* `list_entry:read` (Read list entries)
* `user_management:read` (Read your workspace members)

You'll find more information about Attio scopes
[here](https://docs.attio.com/rest-api/guides/authentication).

## Synchronization

### Refresh Frequency

Qobra keeps your Attio data up to date through regular synchronizations:

* **Scheduled Full Refresh**: on a recurring schedule, we perform a complete sync of all your Attio data
* **On-Demand Updates**: Need the latest data right away? Just click the refresh button in your integration settings

### Total synchronization

This integrations does total synchronization, meaning the whole document will
be synced at every refresh.

Unlike CRMs such as Salesforce or Hubspot, Attio does not expose a record-level
last modified date. As a result, Qobra performs a complete refresh of your data
on every synchronization rather than an incremental one.

### Supported tables

The integration relies on Attio's schema discovery, so it supports all the data
available in your workspace:

* **Objects**: all standard objects (such as `People`, `Companies`, `Deals`)
  as well as any custom object defined in your workspace, with their standard
  and custom attributes.
* **Lists**: each list is synchronized as its own table, including its list
  attributes and its parent record.

User attribution in Qobra is based on your Attio **workspace members**, not on
the standard `Users` object (which represents the end-users of your own product).

### Supported types

You’ll find below the fields types supported by the Qobra integration,
and their mapping to Qobra types.

| **Attio type**     | **Qobra type**                |
| ------------------ | ----------------------------- |
| `text`             | `string`                      |
| `personal-name`    | `string`                      |
| `email-address`    | `string`                      |
| `phone-number`     | `string`                      |
| `domain`           | `string`                      |
| `location`         | `string`                      |
| `number`           | `number`                      |
| `rating`           | `number`                      |
| `currency`         | `amount`                      |
| `checkbox`         | `bool`                        |
| `date`             | `date`                        |
| `timestamp`        | `date`                        |
| `select`           | `picklist` or `multipicklist` |
| `status`           | `picklist` or `multipicklist` |
| `record-reference` | `object`                      |
| `actor-reference`  | `user`                        |

[Contact Qobra support](mailto:support@qobra.co) for more information.
