Attio

​

What’s Supported

​

Supported Actions

This connector supports:

• Read Actions, including full historic backfill. Please note that incremental read is not supported, a full read of the Attio instance will be done for each scheduled read.
• Write Actions.
• Proxy Actions, using the base URL https://api.attio.com.

​

Supported Objects

The Attio connector supports reading to the following objects:

• Object
• Lists
• WorkspaceMembers
• Notes
• Tasks
• Webhooks

The Attio connector supports writing to the following objects:

• Object
• Lists
• Notes
• Tasks
• Webhooks

​

Example integration

To define an integration for Attio, create a manifest file that looks like this: https://github.com/amp-labs/samples/blob/main/attio/amp.yaml

​

Before You Get Started

To connect Attio with Ampersand, you will need an Attio Account.

Once your account is created, you’ll need to create an app in Attio and obtain the following credentials from your app:

• Client ID
• Client Secret

You will then use these credentials to connect your application to Ampersand.

​

Create an Attio Account

Here’s how you can sign up for an Attio account:

• Go to the Attio Sign Up page.
• Sign up using your preferred method.

​

Creating an Attio App

Follow the steps below to create an Attio app and add the Ampersand redirect URL.

1. Log in to your Attio account.

2. Click Account Settings and go to the Developers tab.

3. Click** Create a new integration**.

4. In the Create an integration pop-up window, enter the Integration Name. You can also add a description and app logo.

5. Expand the Scopes section and select the scopes applicable for your app.

6. Expand the OAuth section. Here, you will find the Client ID and Client Secret keys for your app. Make a note of these credentials, as you will need them to connect your app to Ampersand.

7. Enable the OAuth Enabled switch.

8. In the Redirect URIs, add the Ampersand Redirect URI: https://api.withampersand.com/callbacks/v1/oauth.

​

Add Your Attio App Info to Ampersand

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to create an Attio integration.

3. Select Provider Apps.

4. Select Attio from the Provider list.

5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.

6. Click Save Changes.

​

Using the connector

This connector uses API Key auth, which means that you do not need to set up a Provider App before getting started. Provider apps are only required for providers that use OAuth2 (Authorization Code) grant type.

To start integrating with Attio:

• Create a manifest file using the example, see Define Integrations for more info.
• Deploy it using the amp CLI.
• If you are using Read Actions, create a destination.
• Embed the InstallIntegration UI component. The UI component will prompt the customer for an API key.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.