Attio

Read and write access to an Attio CRM workspace via the API v2. Query, fetch, create, update, assert, and delete records for any object; read the object catalog and per-object attribute schemas; list lists and query list entries; and list and create notes and tasks. A raw attio_request action covers any v2 endpoint not exposed as a named action, bounded by the same host allowlist.

Actions

Objects and attribute values

object is an object slug or id. Standard slugs are people, companies, deals, users, and workspaces; custom objects use their own slug.

Attio stores each attribute as a typed value rather than a flat string. Record write actions take a values object keyed by attribute slug, passed through unchanged under Attio's data.values envelope. Call list_attributes for an object to discover its attribute slugs and shapes before writing.

{
  "action": "create_record",
  "object": "people",
  "values": {
    "name": [{ "first_name": "Ada", "last_name": "Lovelace" }],
    "email_addresses": ["ada@example.com"]
  }
}

Auth

Generate a workspace API key in Attio under Workspace Settings > Developers and store it as the attio_api_key secret. The host injects it as an Authorization: Bearer header on requests to api.attio.com; the token is never visible to the tool. Grant the key the record, object-configuration, list, note, and task scopes the actions you use require.

export ATTIO_API_KEY=<the key>
ironclaw tool setup attio-tool

Limits

• Record queries return up to 1000 entries per call (limit, clamped); page with offset.
• Attio rate-limits reads near 100 req/s and writes near 25 req/s; bursts return HTTP 429 with a Retry-After header.
• Write actions (create_*, update_record, assert_record, delete_record) run under the host's ask-first permission by default.