attio-install-auth

# 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](https://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 ```bash # .env (add to .gitignore imme...