> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attio

> Connect Attio to your Atako agents — 21 read and 18 write actions.

Let your agents work in your Attio CRM — query and update records, manage lists, notes, tasks and comments.

## Connection

* **Authentication**: API key.

<Note>
  Attio → click your workspace name (top left) → Workspace settings → Developers → Create a new integration → under "Scopes" enable at least: Object configuration (read), Records (read-write), Lists & entries (read-write), Notes (read-write), Tasks (read-write), Comments (read-write), User management (read) → copy the API key.

  See [Attio's documentation](https://attio.com/help/reference/integrations-automations/generating-an-api-key).
</Note>

## Read actions (21)

| Action                   | Description                                                               |
| ------------------------ | ------------------------------------------------------------------------- |
| `get_comment`            | Fetch a single comment by id.                                             |
| `get_list`               | Fetch a single list by slug or id.                                        |
| `get_list_entry`         | Fetch a single list entry by id.                                          |
| `get_note`               | Fetch a single note by id.                                                |
| `get_object`             | Fetch a single object definition by slug or id (e.g. people, companies).  |
| `get_record`             | Fetch a single record by id.                                              |
| `get_self`               | Fetch the workspace and permissions the API key belongs to.               |
| `get_task`               | Fetch a single task by id.                                                |
| `get_thread`             | Fetch a comment thread with all its comments.                             |
| `get_webhook`            | Fetch a single webhook by id.                                             |
| `get_workspace_member`   | Fetch a single workspace member by id.                                    |
| `list_attributes`        | List the attributes defined on an object or a list.                       |
| `list_list_entries`      | Query (list) the entries of a list with optional filter and sorts.        |
| `list_lists`             | List all lists the API key can access.                                    |
| `list_notes`             | List notes, optionally filtered by parent record.                         |
| `list_objects`           | List all objects (standard and custom) in the workspace.                  |
| `list_tasks`             | List tasks, optionally filtered by linked record, assignee or completion. |
| `list_threads`           | List comment threads on a record or list entry.                           |
| `list_webhooks`          | List webhooks registered by this integration.                             |
| `list_workspace_members` | List all workspace members (useful to resolve assignee/author ids).       |
| `query_records`          | Query (search/list) records of an object with optional filter and sorts.  |

## Write actions (18)

| Action              | Description                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| `assert_record`     | Upsert a record matched by a unique attribute (e.g. email\_addresses, domains). |
| `create_comment`    | Post a comment on a thread, a record or a list entry, as a workspace member.    |
| `create_list`       | Create a list for records of a given parent object.                             |
| `create_list_entry` | Add a record to a list, optionally setting entry attribute values.              |
| `create_note`       | Create a note on a record.                                                      |
| `create_object`     | Create a custom object type in the workspace.                                   |
| `create_record`     | Create a record (e.g. a person or company) with attribute values.               |
| `create_task`       | Create a task, optionally linked to records and assigned to members.            |
| `create_webhook`    | Register a webhook delivering the given event types to an HTTPS URL.            |
| `delete_comment`    | Permanently delete a comment (deleting the first comment deletes the thread).   |
| `delete_list_entry` | Remove an entry from a list (the parent record is kept).                        |
| `delete_note`       | Permanently delete a note.                                                      |
| `delete_record`     | Permanently delete a record.                                                    |
| `delete_task`       | Permanently delete a task.                                                      |
| `delete_webhook`    | Delete a webhook so it stops receiving events.                                  |
| `update_list_entry` | Update attribute values on a list entry (appends to multiselect attributes).    |
| `update_record`     | Update attribute values on a record (appends to multiselect attributes).        |
| `update_task`       | Update a task (deadline, completion, linked records, assignees).                |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.