> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Attio

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Find every workspace where the deal value exceeds \$100k and the last activity was over 14 days ago.
* Log a note on the Acme Corp record summarizing this morning's call from the meeting transcript.
* Add the new contacts I imported today to the `Q2 Outbound` list and assign them to me.

## Available Tools

#### list_entries

Query entries of a list with pagination. Use list_lists to find valid list slugs. Supports limit and offset for pagin...

#### get_entry

Get a single list entry by ID. Use list_entries to find valid entry IDs.

#### create_entry

Add a record to a list as a new entry. Requires parent_object slug and parent_record_id. Use list_records or search_r...

#### delete_entry

Remove an entry from a list. This does not delete the underlying record. Use list_entries to find valid entry IDs.

#### list_lists

List all lists in the Attio workspace. Lists are collections of records (e.g. sales pipeline, hiring pipeline).

#### get_list

Get a single list definition by slug or ID. Use list_lists to find valid slugs.

#### create_list

Create a new list. Requires a name and parent_object (e.g. 'people', 'companies'). Use list_objects to find valid par...

#### list_notes

List all notes in the workspace with pagination. Notes are attached to records. Use limit and offset for pagination.

#### get_note

Get a single note by ID. Use list_notes to find valid note IDs.

#### create_note

Create a note attached to a record. Requires parent_object slug and parent_record_id. Use list_records or search_reco...

#### delete_note

Delete a note by ID. This action is irreversible. Use list_notes to find valid note IDs.

#### list_objects

List all objects in the Attio workspace (e.g. people, companies, deals). Returns object definitions with slugs and di...

#### get_object

Get a single object definition by slug or ID. Use list_objects to find valid slugs (e.g. 'people', 'companies').

#### list_attributes

List all attributes of an object or list. Set target to 'objects' or 'lists' and target_id to the slug/ID. Use list_o...

#### list_records

Query records of an object with optional filtering and sorting. Use list_attributes to find valid attribute slugs for...

#### get_record

Get a single record by ID. Use list_records or search_records to find valid record IDs.

#### create_record

Create a new record on an object. Use list_attributes to find writable attribute slugs and expected value formats.

#### update_record

Update an existing record's attribute values. Only provided attributes are updated. Use list_attributes to find writa...

#### delete_record

Delete a record by ID. This action is irreversible. Use list_records or search_records to find valid record IDs.

#### assert_record

Upsert a record: create if no match exists, update if a record matches on the matching_attribute. Useful for deduplic...

#### search_records

Search records across one or more objects by text query. Returns matching records with display text. Limit results wi...

#### list_tasks

List all tasks in the workspace with pagination. Tasks can be linked to records and assigned to workspace members.

#### get_task

Get a single task by ID. Use list_tasks to find valid task IDs.

#### create_task

Create a new task. Optionally link to records and assign to workspace members. Use list_workspace_members to find val...

#### update_task

Update a task's content, deadline, completion status, linked records, or assignees. Only provided fields are updated.

#### delete_task

Delete a task by ID. This action is irreversible. Use list_tasks to find valid task IDs.

#### list_webhooks

List all webhooks registered in the workspace. Shows target URLs, subscriptions, and status.

#### create_webhook

Create a webhook to receive event notifications. Provide a target_url and subscriptions with event types (e.g. 'recor...

#### delete_webhook

Delete a webhook by ID. This stops all event delivery to the webhook URL. Use list_webhooks to find valid IDs.

#### list_workspace_members

List all members of the Attio workspace. Returns names, emails, and access levels. Useful for finding assignee IDs fo...