Docs / Workflows / Integrations / Attio
Attio
Read and update CRM records, list entries, notes, tasks and comments in an Attio workspace.
What you can do
Each Attio integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Attio.
- Lead records
- Create or update a person for each new lead.
- Call notes
- Add a note to a deal after each customer call.
- Follow-up tasks
- Create a follow-up task when a deal changes.
Connection scope
Objects define record types such as people or companies. Attributes define their fields. Lists contain entries linked to records and can have their own attributes. Object records and list entries use different IDs and field definitions.
Connecting
Authorize the OAIZ app for the Attio workspace you want to connect. Attio shows the app’s configured permissions during approval. OAIZ then creates a webhook in that workspace to receive changes.
- Read permissions
- object_configuration:read, list_configuration:read and user_management:read.
- Read and write permissions
- record_permission:read-write, list_entry:read-write, note:read-write, task:read-write, comment:read-write and webhook:read-write.
These permissions cover the tools below and registration of the workspace webhook. Attio configures the permission bundle on the app, and shows it during installation.
Read actions
- List Objects
- List Attio object definitions with slugs and IDs.
- List Attributes
- List attributes defined on an Attio object or list.
- List Records
- List an object’s records with optional filters, sorting and pagination.
- Get Record
- Get a single Attio record by object and record ID.
- List Lists
- List Attio lists the connected workspace token can access.
- Get List
- Get one Attio list by slug or UUID.
- List Entries
- List a list’s entries with optional filters, sorting and pagination.
- Get Entry
- Get a single Attio list entry by list and entry ID.
- List Workspace Members
- List Attio workspace members with IDs, names, emails, and access levels.
- List Notes
- List Attio notes, optionally scoped to a linked record.
- Get Note
- Get one Attio note by note ID.
- List Tasks
- List Attio tasks, optionally scoped to a linked record.
- Get Task
- Get one Attio task by task ID.
- List Threads
- Read comment threads for a selected record or list entry.
- Get Thread
- Get one Attio comment thread with comments by thread ID.
- Get Comment
- Get one Attio comment by comment ID.
Write actions
- Create Record
- Create an object record with attribute values.
- Assert Record
- Create or update a record matched by a unique attribute. Supplied values replace the existing values, including multiselect attributes.
- Update Record
- Change a record’s supplied attributes. Multiselect values are added to the existing set.
- Create Entry
- Add a record to a list with optional entry attribute values.
- Update Entry
- Change a list entry’s supplied attributes. Multiselect values are added to the existing set.
- Create Note
- Add a note to a record in plain text or Markdown.
- Create Task
- Create a plaintext Attio task with optional deadline, linked records, and workspace-member assignees.
- Update Task
- Update an Attio task's deadline, completion state, linked records, or assignees.
- Create Comment
- Add a plaintext comment to an existing thread, record or list entry.
Events
Attio publishes supported record, list-entry, note, task and comment changes. Some record events also identify the object type. The event’s IDs locate the record or entry for further reads.