| name | attio-install-auth |
| description | Set up Attio REST API authentication with access tokens or OAuth 2.0.
Use when configuring API keys, setting token scopes, initializing
the Attio client, or connecting an app via OAuth.
Trigger: "install attio", "setup attio", "attio auth", "attio API key",
"attio OAuth", "attio access token".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(npx:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","crm","attio"] |
| compatible-with | claude-code |
Attio Install & Auth
Overview
Configure authentication for the Attio REST API (https://api.attio.com/v2). Attio offers two auth methods: access tokens (scoped to a single workspace) and OAuth 2.0 (for multi-workspace integrations). There is no official first-party Node SDK -- use fetch or a community client like attio-js.
Prerequisites
- Node.js 18+ or Python 3.10+
- Attio account at app.attio.com
- API access enabled in workspace settings
Instructions
Step 1: Generate an Access Token
- Open Settings > Developers > Access tokens in your Attio workspace
- Click Create token and name it (e.g.,
my-integration-dev)
- Configure scopes (tokens have no scopes by default -- you must add them):
| Scope | Grants access to |
|---|
object_configuration:read | List/get objects and attributes |
record_permission:read | Read records (people, companies, deals) |
record_permission:read-write | Create/update/delete records |
list_entry:read | Read list entries |
list_entry:read-write | Create/update/delete list entries |
note:read-write | Create and read notes |
task:read / task:read-write | Read or manage tasks |
user_management:read | Read workspace members |
webhook:read-write | Manage webhooks |
- Copy the token -- it starts with
sk_ and never expires (but can be revoked)
Step 2: Configure Environment
ATTIO_API_KEY=sk_your_token_here
.
.env.local
..*.
