attio-install-auth

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 <[e-mail]>
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

1. Open Settings > Developers > Access tokens in your Attio workspace
2. Click Create token and name it (e.g., my-integration-dev)
3. 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

4. Copy the token -- it starts with sk_ and never expires (but can be revoked)

Step 2: Configure Environment

# .env (add to .gitignore immediately)
ATTIO_API_KEY=sk_your_token_here

# .gitignore
.
.env.local
..*.