> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-docs.mintlify.site/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.

### Others

| 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)         |
| `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)      |
| `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)            |
| `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)            |
| `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)          |
| `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)          |
| `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)            |
| `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-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)         |
| `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)      |
| `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)            |
| `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)          |
| `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)            |
| `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-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)            |
| `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)         |
| `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)               |
| `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)               |
| `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)             |
| `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)             |
| `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)               |
| `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)            |
| `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)   |
| `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)             |
| `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)             |
| `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)           |
| `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)           |
| `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)             |
| `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)          |
| `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) |
| `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)      |
| `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)            |
| `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)          |
| `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)          |
| `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)            |
| `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)         |
| `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)      |
| `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)          |
| `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)        |

***