attio

Attio CRM

Manage Attio CRM via REST API. Supports companies, people, deals, lists (pipelines), notes, and tasks.

Setup

Set ATTIO_API_KEY in environment or ~/.env:

echo "ATTIO_API_KEY=your_api_key" >> ~/.env

Get your API key: Attio → Workspace Settings → Developers → New Access Token

Quick Reference

Objects (Records)

# List/search records
attio objects list                     # List available objects
attio records list <object>            # List records (companies, people, deals, etc.)
attio records search <object> <query>  # Search by text
attio records get <object> <id>        # Get single record
attio records create <object> <json>   # Create record
attio records update <object> <id> <json>  # Update record

Lists (Pipelines)

attio lists list                       # Show all pipelines/lists
attio entries list <list_slug>         # List entries in a pipeline
attio entries add <list_slug> <object> <record_id>  # Add record to pipeline

Notes

attio notes list <object> <record_id>  # Notes on a record
attio notes create <object> <record_id> <title> <content>

Tasks

attio tasks list                       # All tasks
attio tasks create <content> [deadline]  # Create task (deadline: YYYY-MM-DD)
attio tasks complete <task_id>         # Mark complete

Examples

Find a company and add a note

# Search for company
attio records search companies "Acme"

# Add note to the company (using record_id from search)
attio notes create companies abc123-uuid "Call Notes" "Discussed Q1 roadmap..."

Work with pipeline

# List pipeline stages
attio entries list sales_pipeline

# Add a company to pipeline
attio entries add sales_pipeline companies abc123-uuid

Create a follow-up task

attio tasks create "Follow up with John at Acme" "2024-02-15"

API Limits

• Rate limit: ~100 requests/minute
• Pagination: Use limit and offset params for large datasets

Full API Docs

https://docs.attio.com/