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

# Attio

> How to set up the Attio connector, plus the actions and events that are available.

![Attio](https://stackone-logos.com/api/attio/filled/svg)

v2.0.0[See changelog](https://docs.stackone.com/connectors/attio/changelog.md)

[126 actions](#actions) · [27 events](#events) · 3 auth methods

CRM
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [MCP (OAuth) · Connector Profile](https://docs.stackone.com/connectors/attio/guides/connector-profile/mcp-oauth.md)
>
> Authorize through the MCP server. Endpoints and client registration are discovered at connect time.

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/attio/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an OAuth app in Attio.

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/attio/guides/connector-profile/api-key.md)
>
> Best for single-workspace integrations and internal tools. Provides full API access scoped to your workspace.

Optionally, configure receiving Events for Attio into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/attio/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [MCP (OAuth) · Link Account](https://docs.stackone.com/connectors/attio/guides/link-account/mcp-oauth.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/attio/guides/link-account/oauth-2-0.md)

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/attio/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Key

MCP (OAuth)

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

comment:read

comment:read-write

list\_configuration:read

list\_configuration:read-write

list\_entry:read

list\_entry:read-write

note:read

note:read-write

object\_configuration:read

object\_configuration:read-write

record\_permission:read

record\_permission:read-write

task:read

task:read-write

user\_management:read

webhook:read

webhook:read-write

No scopes found

126 actions

ActionDescriptionRequired scopes

List Attributes`attio_list_attributes`

List all attributes defined on a specific object or list

`object_configuration:read`

Get Attribute`attio_get_attribute`

Get information about a single attribute on an object or list

`object_configuration:read`

Create Attribute`attio_create_attribute`

Create a new attribute on an object or list

`object_configuration:read-write`

Update Attribute`attio_update_attribute`

Update a single attribute on an object or list

`object_configuration:read-write`

List Statuses`attio_list_statuses`

List all statuses for a status attribute

`object_configuration:read`

Create Status`attio_create_status`

Add a new status to a status attribute

`object_configuration:read-write`

Update Status`attio_update_status`

Update a status on a status attribute

`object_configuration:read-write`

Get Comment`attio_get_comment`

Get a single comment by ID

`comment:read`

Create Comment`attio_create_comment`

Create a new comment on a thread, record, or list entry

`comment:read-write`

Delete Comment`attio_delete_comment`

Delete a comment by ID

`comment:read-write`

List Companies`attio_list_companies`

Retrieve a paginated list of all companies in the workspace

`record_permission:read``object_configuration:read`

Get Company`attio_get_company`

Retrieve a specific company by its record ID

`record_permission:read``object_configuration:read`

Create Company`attio_create_company`

Create a new company record in Attio. This endpoint will throw on conflicts of unique attributes like domains

`record_permission:read-write``object_configuration:read`

Update Company`attio_update_company`

Update an existing company record. Multiselect attribute values supplied will be created and prepended to existing value...

`record_permission:read-write``object_configuration:read`

Delete Company`attio_delete_company`

Delete a company record from Attio. Deletes should be handled extremely carefully

`record_permission:read-write``object_configuration:read`

Get Unified Credentials`attio_unified_get_me`

Get the current Attio connection's unified credentials and identity.

IAM Auth Test`attio_auth_test`

Validate the current token and return the raw, unmapped Attio /v2/self response (workspace\_id, workspace\_name, workspace...

List Unified Organizations`attio_unified_list_organizations`

List the single Attio workspace the connection is bound to.

Get Unified Organization`attio_unified_get_organization`

Get the single Attio workspace the connection is bound to.

List Unified Resource Types`attio_unified_list_resource_types`

List unified resource types in Attio.

List Unified Resource Users`attio_unified_list_resource_users`

List unified resource users in Attio.

`list_configuration:read``user_management:read`

List Unified Roles`attio_unified_list_roles`

Return the stable workspace and list-access IAM roles synthesized from Attio's access\_level and list ACL enums.

Get Unified Role`attio_unified_get_role`

Retrieve a single synthesized Attio IAM role by its stable key (workspace or list-access role).

List Unified Users`attio_unified_list_users`

List unified users in Attio.

`user_management:read`

Get Unified User`attio_unified_get_user`

Get a unified Attio user by ID.

`user_management:read`

List Lists`attio_list_lists`

Retrieve all lists in the workspace

`list_configuration:read`

Get List`attio_get_list`

Retrieve a specific list by its ID or slug

`list_configuration:read`

Create List`attio_create_list`

Create a new list in the workspace

`list_configuration:read-write`

Update List`attio_update_list`

Update an existing list's name, slug, or access permissions

`list_configuration:read-write`

List List Entries`attio_list_list_entries`

Retrieve all entries (records) in a specific list

`list_entry:read``list_configuration:read`

Get List Entry`attio_get_list_entry`

Retrieve a specific list entry by its ID

`list_entry:read``list_configuration:read`

Create List Entry`attio_create_list_entry`

Add a record to a list

`list_entry:read-write``list_configuration:read`

Update List Entry`attio_update_list_entry`

Update an existing list entry's attribute values

`list_entry:read-write``list_configuration:read`

Delete List Entry`attio_delete_list_entry`

Remove a record from a list

`list_entry:read-write``list_configuration:read`

Create Activity Record`attio_create_activity_record`

Create a new record for a given activity, for example one specific phone call. IMPORTANT: Before calling this tool, you...

Create Comment`attio_mcp_create_comment`

Creates a new comment on a record, list entry, or as a reply to an existing comment thread. Provide exactly one of: (par...

Add Record To List`attio_add_record_to_list`

Add a record to a list as a new list entry. IMPORTANT: Before calling this tool: 1) You should call list-list-attribute-...

Create List`attio_mcp_create_list`

Creates a new list in Attio. Lists are used to group and track records of a single object type (e.g. a sales pipeline of...

Create Note`attio_mcp_create_note`

Creates a new note attached to a record. Returns the created note's ID.

Create Record`attio_mcp_create_record`

Create a new record in a given object. IMPORTANT: Before calling this tool, you should call list-attribute-definitions f...

Create Task`attio_mcp_create_task`

Creates a new task in Attio. Tasks can optionally have a deadline, assignees (workspace members), and linked records (e....

Create View`attio_create_view`

Create a saved view of an object or a list. A view is a table or kanban board with a filter, sorts and shown attributes,...

Delete Comment`attio_mcp_delete_comment`

Deletes a comment. You can only delete comments that you created. Deleting a parent comment will also delete all of its...

Delete Task`attio_mcp_delete_task`

Deletes a task. Call list-tasks to find the ID of the task you want to delete.

Delete View`attio_delete_view`

Delete a saved view of an object or a list. The view is removed for everyone in the workspace and cannot be restored. Re...

Get Call Recording`attio_get_call_recording`

Retrieves the full details of a call recording by ID, including its status, timestamps, and complete transcript.

Get Email Content`attio_get_email_content`

Retrieves the full content/body of an email. Requires the mailbox\_id and email\_header\_id, which can be obtained from ema...

Get Note Body`attio_get_note_body`

Get the body of a note by its ID

Get Records By IDs`attio_get_records_by_ids`

Retrieve a given set of records by their IDs for a given object. Returns an array of records with their attribute values...

Get View`attio_get_view`

Get a saved view of an object or a list with its title, type (table or kanban), filter, sorts, shown attributes and, for...

Attio`attio_render_home`

Renders the user's Attio home page: suggested prompts, their open tasks and today's meetings. The user opens it from the...

List Activities`attio_list_activities`

List all activities in the Attio workspace. Activities model things that happen over time, such as phone calls or meetin...

List Activity Attribute Definitions`attio_list_activity_attribute_definitions`

List attribute definitions for a given activity

List Activity Records`attio_list_activity_records`

List records for a given activity, such as phone calls or meetings, with optional filtering and sorting. Returns paginat...

List Attribute Definitions`attio_list_attribute_definitions`

List attribute definitions for a given object

List Comment Replies`attio_list_comment_replies`

Lists replies to a comment. Provide the comment\_id of a top-level comment to fetch its replies. Cannot be used with repl...

List Comments`attio_list_comments`

Lists comments on a record or list entry. Returns paginated top-level comments with up to 5 replies each. If a thread ha...

List List Attribute Definitions`attio_list_list_attribute_definitions`

List attribute definitions for a given list

List Lists`attio_mcp_list_lists`

List all lists in the Attio workspace. Returns list metadata including ID, name, API slug, and parent object types. Use...

List Objects`attio_mcp_list_objects`

List all objects in the Attio workspace. Objects are the types of record the workspace stores, such as companies, people...

List Records In List`attio_list_records_in_list`

List entries in a given list with optional filtering and sorting. Returns paginated results. Use this tool to retrieve e...

List Records`attio_mcp_list_records`

List records in a given object with optional filtering and sorting. Returns paginated results. Use this tool to retrieve...

List Tasks`attio_mcp_list_tasks`

Lists tasks in the workspace with optional filters. Returns paginated results with task content, completion status, assi...

List Views`attio_list_views`

List the saved views of an object or a list, in the order that the Attio app shows them. A view is a saved table or kanb...

List Workspace Members`attio_mcp_list_workspace_members`

List members in the Attio workspace. Returns a list of matching members with their ID, email address, name, access level...

List Workspace Teams`attio_list_workspace_teams`

List teams in the workspace. Teams are groups of workspace members used primarily for permission management. Returns an...

Merge Records`attio_merge_records`

Merges two records of the same object into one. Where both records have a value for the same attribute, the primary reco...

Render Meetings`attio_render_meetings`

Use this tool to show the user a list of meetings, past and upcoming, with who took part, when they want to see meetings...

Render Record`attio_render_record`

Use this tool to show one record, of any object, to the user as a card: its name, its object, and a few key attributes....

Render Record Updates`attio_render_record_updates`

Use this tool to propose updates to existing records, of any object, for the user to review. It shows a card with each r...

Run Basic Report`attio_run_basic_report`

Run an aggregate report on records in an object or entries in a list. Use this tool when you need totals, averages, mini...

Search Call Recordings By Metadata`attio_search_call_recordings_by_metadata`

Searches all call recordings across the workspace by their metadata. Useful for finding call recordings based on who was...

Search Emails By Metadata`attio_search_emails_by_metadata`

Searches emails visible to the user by their metadata. Useful for finding emails based on participants, domain, and time...

Search Meetings`attio_search_meetings`

Search across past and future meetings in the workspace. Returns paginated results with meeting metadata, participants,...

Search Mentions`attio_search_mentions`

Typeahead search for Attio records, used only by the host's @ mention picker. Not for answering questions: use "search-r...

Search Notes By Metadata`attio_search_notes_by_metadata`

Searches for notes by their metadata. Useful for finding notes based on parent record, meeting, author (workspace member...

Search Records`attio_mcp_search_records`

Perform a full-text search for records in a given object. Only searches indexed attributes: domains, email addresses, ph...

Semantic Search Call Recordings`attio_semantic_search_call_recordings`

Searches all call recordings across the workspace using semantic similarity. Returns call recordings that are most seman...

Semantic Search Emails`attio_semantic_search_emails`

Searches emails visible to the user using semantic similarity. Returns up to 20 emails that are most semantically simila...

Semantic Search Notes`attio_semantic_search_notes`

Searches all notes across the workspace using semantic similarity. Returns up to 20 notes that are most semantically sim...

Update Activity Record`attio_update_activity_record`

Use this tool to update activity records, such as phone calls or meetings, by `record_id`.

Update Data Model`attio_update_data_model`

Change the workspace's data model: create objects, enable standard objects, and create attributes and relationships. All...

Update List Entry By ID`attio_update_list_entry_by_id`

Update attribute values on an existing list entry by its entry ID. Before calling this tool, you must: - Call list-recor...

Update List Entry By Record ID`attio_update_list_entry_by_record_id`

Update attribute values on a list entry by finding it via its parent record ID. IMPORTANT: This tool will error if the r...

Update List`attio_mcp_update_list`

Update a list's name, API slug, or permissions.

Update Note`attio_update_note`

Appends or prepends plain-text content to an existing note and/or updates its title. At least one of `operation` or \`upd...

Update Record`attio_mcp_update_record`

Use this tool to update people, companies, and other records by `record_id`.

Update Task`attio_mcp_update_task`

Updates an existing task in Attio. You can update the deadline, completion status, assignees, and linked records. assign...

Update View`attio_update_view`

Update the title, type, filter, sorts, shown attributes or kanban settings of a saved view of an object or a list. Only...

Upsert Activity Record`attio_upsert_activity_record`

Use this tool to create or update activity records, such as phone calls or meetings. A matching attribute is used to sea...

Upsert Record`attio_upsert_record`

Use this tool to create or update people, companies and other records. A matching attribute is used to search for existi...

Who Am I`attio_whoami`

Returns information about the current user's identity and workspace membership, including their email, name, workspace m...

List Notes`attio_list_notes`

List notes for all records or for a specific record

`note:read``object_configuration:read``record_permission:read`

Get Note`attio_get_note`

Retrieve a specific note by its ID

`note:read``object_configuration:read``record_permission:read`

Create Note`attio_create_note`

Create a new note for a given record

`note:read-write``object_configuration:read``record_permission:read`

Delete Note`attio_delete_note`

Delete a single note by ID

`note:read-write`

List Objects`attio_list_objects`

List all system-defined and user-defined objects in the workspace

`object_configuration:read`

Get Object`attio_get_object`

Get a single object by its ID or slug

`object_configuration:read`

Create Object`attio_create_object`

Create a new custom object in the workspace

`object_configuration:read-write`

Update Object`attio_update_object`

Update an existing object's configuration

`object_configuration:read-write`

List People`attio_list_people`

Retrieve a paginated list of all people (contacts) in the workspace

`record_permission:read``object_configuration:read`

Get Person`attio_get_person`

Retrieve a specific person by their record ID

`record_permission:read``object_configuration:read`

Create Person`attio_create_person`

Create a new person (contact) record in Attio. This endpoint will throw on conflicts of unique attributes like email\_add...

`record_permission:read-write``object_configuration:read`

Update Person`attio_update_person`

Update an existing person record. Multiselect attribute values supplied will be created and prepended to existing values

`record_permission:read-write``object_configuration:read`

Delete Person`attio_delete_person`

Delete a person record from Attio

`record_permission:read-write``object_configuration:read`

List Records`attio_list_records`

List people, company or other records, with the option to filter and sort results

`record_permission:read``object_configuration:read`

Get Record`attio_get_record`

Get a single person, company or other record by its record\_id

`record_permission:read``object_configuration:read`

Create Record`attio_create_record`

Create a new person, company or other record. This endpoint will throw on conflicts of unique attributes

`record_permission:read-write``object_configuration:read`

Update Record`attio_update_record`

Update an existing record. Multiselect attribute values supplied will be created and prepended to existing values

`record_permission:read-write``object_configuration:read`

Delete Record`attio_delete_record`

Delete a single record (e.g., a company or person) by ID

`object_configuration:read``record_permission:read-write`

Search Records`attio_search_records`

Fuzzy search for records across one or more objects by name, email, domain, phone, or social handles

`record_permission:read``object_configuration:read`

List Tasks`attio_list_tasks`

Retrieve all tasks in the workspace, sorted by creation date from oldest to newest

`task:read``object_configuration:read``record_permission:read``user_management:read`

Get Task`attio_get_task`

Retrieve a specific task by its ID

`task:read``object_configuration:read``record_permission:read``user_management:read`

Create Task`attio_create_task`

Create a new task with plaintext content, optional deadline, linked records, and assignees

`task:read-write``object_configuration:read``record_permission:read``user_management:read`

Update Task`attio_update_task`

Update an existing task's deadline, completion status, linked records, or assignees

`task:read-write``object_configuration:read``record_permission:read``user_management:read`

Delete Task`attio_delete_task`

Delete a task from Attio

`task:read-write`

List Threads`attio_list_threads`

List threads of comments on a record or list entry

`comment:read`

Get Thread`attio_get_thread`

Get all comments in a thread by thread ID

`comment:read`

List Webhooks`attio_list_webhooks`

List all webhooks in the workspace

`webhook:read`

Get Webhook`attio_get_webhook`

Get a single webhook by ID

`webhook:read`

Create Webhook`attio_create_webhook`

Create a new webhook

`webhook:read-write`

Update Webhook`attio_update_webhook`

Update a webhook by ID

`webhook:read-write`

Delete Webhook`attio_delete_webhook`

Delete a webhook by ID

`webhook:read-write`

List Workspace Members`attio_list_workspace_members`

Retrieve all workspace members (users) in the workspace

`user_management:read`

Get Workspace Member`attio_get_workspace_member`

Retrieve a specific workspace member by their ID

`user_management:read`

Identify Current Workspace`attio_identify`

Get information about the current access token, the workspace it is linked to, and its permissions

## Events

Tags

Select all
|
Clear

Attributes

Call Recordings

Comments

Entries

Lists

Notes

Objects

Records

Tasks

Workspace Members

No tags found

27 events

EventDescriptionTags

Record Created Webhook`attio_webhook_record_created`

Processes Attio record.created events.

Records

Record Updated Webhook`attio_webhook_record_updated`

Processes Attio record.updated events.

Records

Record Deleted Webhook`attio_webhook_record_deleted`

Processes Attio record.deleted events.

Records

Record Merged Webhook`attio_webhook_record_merged`

Processes Attio record.merged events.

Records

List Created Webhook`attio_webhook_list_created`

Processes Attio list.created events.

Lists

List Updated Webhook`attio_webhook_list_updated`

Processes Attio list.updated events.

Lists

List Deleted Webhook`attio_webhook_list_deleted`

Processes Attio list.deleted events.

Lists

List Entry Created Webhook`attio_webhook_list_entry_created`

Processes Attio list-entry.created events.

ListsEntries

List Entry Updated Webhook`attio_webhook_list_entry_updated`

Processes Attio list-entry.updated events.

ListsEntries

List Entry Deleted Webhook`attio_webhook_list_entry_deleted`

Processes Attio list-entry.deleted events.

ListsEntries

Note Created Webhook`attio_webhook_note_created`

Processes Attio note.created events.

Notes

Note Updated Webhook`attio_webhook_note_updated`

Processes Attio note.updated events.

Notes

Note Deleted Webhook`attio_webhook_note_deleted`

Processes Attio note.deleted events.

Notes

Note Content Updated Webhook`attio_webhook_note_content_updated`

Processes Attio note-content.updated events.

Notes

Task Created Webhook`attio_webhook_task_created`

Processes Attio task.created events.

Tasks

Task Updated Webhook`attio_webhook_task_updated`

Processes Attio task.updated events.

Tasks

Task Deleted Webhook`attio_webhook_task_deleted`

Processes Attio task.deleted events.

Tasks

Comment Created Webhook`attio_webhook_comment_created`

Processes Attio comment.created events.

Comments

Comment Resolved Webhook`attio_webhook_comment_resolved`

Processes Attio comment.resolved events.

Comments

Comment Unresolved Webhook`attio_webhook_comment_unresolved`

Processes Attio comment.unresolved events.

Comments

Comment Deleted Webhook`attio_webhook_comment_deleted`

Processes Attio comment.deleted events.

Comments

Object Attribute Created Webhook`attio_webhook_object_attribute_created`

Processes Attio object-attribute.created events.

ObjectsAttributes

Object Attribute Updated Webhook`attio_webhook_object_attribute_updated`

Processes Attio object-attribute.updated events.

ObjectsAttributes

List Attribute Created Webhook`attio_webhook_list_attribute_created`

Processes Attio list-attribute.created events.

ListsAttributes

List Attribute Updated Webhook`attio_webhook_list_attribute_updated`

Processes Attio list-attribute.updated events.

ListsAttributes

Workspace Member Created Webhook`attio_webhook_workspace_member_created`

Processes Attio workspace-member.created events.

Workspace Members

Call Recording Created Webhook`attio_webhook_call_recording_created`

Processes Attio call-recording.created events.

Call Recordings


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.