Attio integration

In short

Query, create and update records and lists, and add notes. Connect it on the Integrations page; your app then calls Attio through Sapilon without ever holding an Attio credential.

Lets your app query, read, create and update records of any object (people, companies, deals, custom ones), read lists and add notes, with an Attio workspace access token.

Connecting

On the Integrations page choose Connect on Attio and fill in:

Access token — Attio → Workspace settings → Developers → New access token. Grant record and object read-write, list read and note read-write.

Sapilon checks the key with the provider before it saves it, and stores it encrypted; it is never shown again.

What your app can do

Only these requests are available; anything else is refused.

GET /v2/objects
POST /v2/objects/*/records/query
POST /v2/objects/*/records
GET|PATCH /v2/objects/*/records/*
GET /v2/lists
POST /v2/notes

How the agent uses it

Use integrations.request('attio', …); paths are relative to https://api.attio.com. {object} is a slug such as people, companies or deals.

GET /v2/objects — objects and their slugs.
POST /v2/objects/{object}/records/query — Example: { method: 'POST', path: '/v2/objects/companies/records/query', body: { filter: { domains: 'acme.com' }, limit: 20 } }.
POST /v2/objects/{object}/records — create. Example: { method: 'POST', path: '/v2/objects/people/records', body: { data: { values: { email_addresses: ['sara@acme.com'] } } } }.
GET|PATCH /v2/objects/{object}/records/{id} — read or update data.values.
GET /v2/lists — lists in the workspace.
POST /v2/notes — Example: { method: 'POST', path: '/v2/notes', body: { data: { parent_object: 'companies', parent_record_id: 'r1', title: 'Call', format: 'plaintext', content: 'Will renew' } } }.

Deleting is not allowed.