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

# Attio

> Integrate your application with the Attio API

## 🚀 Quickstart

Connect to Attio with Nango and see data flow in 2 minutes.

<Steps>
  <Step title="Create the integration">
    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Attio*.
  </Step>

  <Step title="Authorize Attio">
    Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then log in to Attio. Later, you'll let your users do the same directly from your app.
  </Step>

  <Step title="Call the Attio API">
    Let's make your first request to the Attio API (fetch a list of people). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

    <Tabs>
      <Tab title="cURL">
        ```bash theme={null}
        curl -X POST  "https://api.nango.dev/proxy/v2/objects/people/records/query" \
          -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
          -H "Provider-Config-Key: <INTEGRATION-ID>" \
          -H "Connection-Id: <CONNECTION-ID>" \
          -H "Accept: application/json" \
          -H "Content-Type: application/json" \
          -d '{"limit": 10}'
        ```
      </Tab>

      <Tab title="Node">
        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:

        ```typescript theme={null}
        import { Nango } from '@nangohq/node';

        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

        const res = await nango.post({
            endpoint: '/v2/objects/people/records/query',
            providerConfigKey: '<INTEGRATION-ID>',
            connectionId: '<CONNECTION-ID>',
            data: {
              limit: 10
            }
          });
        console.log(JSON.stringify(res.data, 2, null));
        ```
      </Tab>
    </Tabs>

    Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get).

    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
  </Step>

  <Step title="Implement Nango in your app">
    Follow our [Auth implementation guide](/guides/primitives/auth) to integrate Nango in your app.

    To obtain your own production credentials, follow the setup guide linked below.
  </Step>
</Steps>

## 📚 Attio Integration Guides

Nango maintained guides for common use cases.

* [How to register your own Attio OAuth app](/api-integrations/attio/how-to-register-your-own-attio-api-oauth-app)\
  Register an OAuth app with Attio and obtain credentials to connect it to Nango

Official docs: [Attio API documentation](https://developers.attio.com/reference)

## 🧩 Pre-built syncs & actions for Attio

Enable them in your dashboard. Extend and customize to fit your needs.

### Comments

| Function name    | Description                                          | Type                                         | Source code                                                                                                          |
| ---------------- | ---------------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `create-comment` | Create a comment on a record or list entry in Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-comment.ts) |
| `delete-comment` | Delete a comment in Attio                            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-comment.ts) |
| `get-comment`    | Retrieve a single comment from Attio.                | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-comment.ts)    |

### List Entries

| Function name       | Description                                               | Type                                         | Source code                                                                                                             |
| ------------------- | --------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `create-list-entry` | Create a list entry in Attio by adding a record to a list | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-list-entry.ts) |
| `delete-list-entry` | Delete or archive a list entry in Attio                   | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-list-entry.ts) |
| `get-list-entry`    | Retrieve a single list entry from Attio.                  | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-list-entry.ts)    |
| `update-list-entry` | Update a list entry in Attio.                             | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-list-entry.ts) |

### Lists

| Function name       | Description                                                       | Type                                         | Source code                                                                                                             |
| ------------------- | ----------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `create-list`       | Create a list in Attio.                                           | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-list.ts)       |
| `get-list`          | Retrieve a single list from Attio.                                | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-list.ts)          |
| `list-list-entries` | List list entries from Attio.                                     | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-list-entries.ts) |
| `list-lists`        | List lists from Attio.                                            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-lists.ts)        |
| `update-list`       | Update a list in Attio.                                           | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-list.ts)       |
| `upsert-list-entry` | Create or update a list entry in Attio by matching parent record. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/upsert-list-entry.ts) |

### Notes

| Function name | Description                        | Type                                         | Source code                                                                                                       |
| ------------- | ---------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `create-note` | Create a note in Attio.            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-note.ts) |
| `delete-note` | Delete or archive a note in Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-note.ts) |
| `get-note`    | Retrieve a single note from Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-note.ts)    |
| `list-notes`  | List notes from Attio.             | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-notes.ts)  |

### Objects

| Function name   | Description                          | Type                                         | Source code                                                                                                         |
| --------------- | ------------------------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `create-object` | Create a custom object in Attio      | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-object.ts) |
| `get-object`    | Retrieve a single object from Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-object.ts)    |
| `list-objects`  | List objects from Attio.             | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-objects.ts)  |
| `update-object` | Update an object in Attio.           | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-object.ts) |

### Records

| Function name   | Description                                                     | Type                                         | Source code                                                                                                         |
| --------------- | --------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `create-record` | Create a record in Attio                                        | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-record.ts) |
| `delete-record` | Delete or archive a record in Attio.                            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-record.ts) |
| `get-record`    | Retrieve a single record from Attio.                            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-record.ts)    |
| `list-records`  | List records from Attio                                         | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-records.ts)  |
| `update-record` | Update a record in Attio.                                       | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-record.ts) |
| `upsert-record` | Create or update a record in Attio by matching attribute value. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/upsert-record.ts) |

### Tasks

| Function name | Description                        | Type                                         | Source code                                                                                                       |
| ------------- | ---------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `create-task` | Create a task in Attio.            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-task.ts) |
| `delete-task` | Delete or archive a task in Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-task.ts) |
| `get-task`    | Retrieve a single task from Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-task.ts)    |
| `list-tasks`  | List tasks from Attio.             | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-tasks.ts)  |
| `update-task` | Update a task in Attio.            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-task.ts) |

### Webhooks

| Function name    | Description                           | Type                                         | Source code                                                                                                          |
| ---------------- | ------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `create-webhook` | Create a webhook in Attio.            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/create-webhook.ts) |
| `delete-webhook` | Delete or archive a webhook in Attio  | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/delete-webhook.ts) |
| `get-webhook`    | Retrieve a single webhook from Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-webhook.ts)    |
| `list-webhooks`  | List webhooks from Attio.             | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-webhooks.ts)  |
| `update-webhook` | Update a webhook in Attio.            | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/update-webhook.ts) |

### Workspace Members

| Function name            | Description                          | Type                                         | Source code                                                                                                                  |
| ------------------------ | ------------------------------------ | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `list-workspace-members` | List all workspace members in Attio. | [Action](/guides/functions/action-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/list-workspace-members.ts) |

### Others

| Function name          | Description                                    | Type                                           | Source code                                                                                                                |
| ---------------------- | ---------------------------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `get-workspace-member` | Retrieve a single workspace member from Attio. | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/actions/get-workspace-member.ts) |
| `companies`            | Sync Attio company records.                    | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/companies.ts)              |
| `deals`                | Sync Attio deal records                        | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/deals.ts)                  |
| `list-entries`         | Sync list entries from Attio.                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/list-entries.ts)           |
| `lists`                | Sync lists from Attio                          | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/lists.ts)                  |
| `meetings`             | Sync meetings from Attio.                      | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/meetings.ts)               |
| `notes`                | Sync notes from Attio.                         | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/notes.ts)                  |
| `objects`              | Sync objects from Attio.                       | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/objects.ts)                |
| `people`               | Sync Attio person records.                     | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/people.ts)                 |
| `records`              | Sync records from Attio.                       | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/records.ts)                |
| `tasks`                | Sync tasks from Attio                          | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/tasks.ts)                  |
| `webhooks`             | Sync webhooks from Attio.                      | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/webhooks.ts)               |
| `workspace-members`    | Sync workspace member profiles from Attio.     | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/attio/syncs/workspace-members.ts)      |

***