Search documentation

Search for a topic, a control, or an event type.

    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.