Skip to main content
Open in Hubv1.0.0 The official Attio integration allows your bot to interact with objects/records in your Attio workspace.

Setup

You will need:
1

Install the integration in Botpress

First, install the integration to your bot:
  1. In Botpress Studio, select Explore Hub in the upper-right corner.
  2. Search for the Attio integration, then select Install Integration.
In the Configuration menu, you should see one field: Access Token. Leave it empty for now—you’ll come back to it after creating your Attio API token.
2

Create an Attio API token

Next, create a Attio API token:
  1. Log in to your Attio account.
  2. Select your workspace name in the upper-left corner. Then, select Workspace settings.
  3. From the left navigation bar, select Developers.
  4. Select + Create access token. Enter a name, then enable the following scopes:
    • Object configuration: Read access
    • Records: Read/write access
  5. Select Save changes, then copy the token.
3

Configure the integration in Botpress

Now, you can finish setting up the integration in Botpress:
  1. In the integration’s Access Token field, paste your Attio API token.
  2. Select Save Configuration.
Your Attio integration is ready. You can use the integration’s Cards to interact with your Attio objects and records..

Cards

When adding filters to the List Records Card, follow Attio’s filtering guide to structure your data.
Here’s a reference for all Cards available with the integration:

Create Record

Input: Output:

Get Object

Input: Output:

Get Record

Input: Output:

List Attributes

Input: Output:

List Objects

Input: This Card has no input fields. Output:

List Records

Input: Output:

Update Record

Input: Output:

Triggers

Here’s a reference for all Triggers available with the integration:
You can access data returned from any of these Triggers by reading event.payload after the Trigger fires.

Record Created

payload
object

Record Deleted

payload
object

Record Updated

payload
object