At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0.
- Connection: A user authorizes the connection in the provider’s consent screen.
- Scopes:
object_configuration:read,record_permission:read-write,list_configuration:read. - Docs: https://docs.attio.com/rest-api/tutorials/connect-an-app-through-oauth
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.Setup
- Create an Attio app: Go to the Attio developer dashboard at https://build.attio.com/ and create a new app. Any Attio workspace (including the free plan) can be used for development.
- Configure OAuth: In the app’s OAuth settings, add the redirect URI <your-app-url>/api/auth/attio/callback and select the scopes object_configuration:read, record_permission:read-write, and list_configuration:read.
- Set credentials: Copy the client ID and client secret from the app settings into your .env as ATTIO_CLIENT_ID and ATTIO_CLIENT_SECRET.
- Verify access: Complete the OAuth flow, then run the List Objects tool followed by Query Records on the people object.
- Attio access tokens expire; refresh tokens are exchanged at https://app.attio.com/oauth/token with grant_type=refresh_token
- Client credentials are sent in the POST body (application/x-www-form-urlencoded) at the token endpoint
- Record values use Attio’s attribute-value format: values are arrays of { value } entries keyed by attribute slug
Tools
| Tool | Access | Description |
|---|---|---|
| List Objects | Read | List object types in the Attio workspace (people, companies, deals, and custom objects) |
| Query Records | Read | Query records of an object with optional filters and sorts |
| Get Record | Read | Get a single record of an object by ID |
| Create Record | Write | Create a new record of an object (person, company, deal, or custom object) |
| Update Record | Write | Update attribute values on an existing record |
| List Lists | Read | List all lists in the Attio workspace |
Example prompts
- Query my Attio companies for a name and show the matching records with their key attributes.
- Create a new person record in Attio with a name and email address.