Attio

Learn how to use Attio with Composio

Overview

SLUG

ATTIO

Description

Attio is a fully customizable workspace for your team’s relationships and workflows.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to task:read-write,object_configuration:read,record_permission:read,user_management:read,list_configuration:read,list_entry:read,comment:read-write
full
stringDefaults to https://api.attio.com
bearer_token
string

Tools

SLUG: ATTIO_CREATE_NOTE

This tool creates a new note on a given record in attio. the note can be attached to any record type (like person, company, or deal) and includes a title and content. it requires parameters such as parent object, parent record id, title, and content, with an optional created at timestamp.

Action Parameters

content
stringRequired
created_at
string
parent_object
stringRequired
parent_record_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_CREATE_RECORD

This tool creates a new record in attio for a specified object type (people, companies, deals, etc.). it requires the object type and a values dictionary containing the attributes for the new record.

Action Parameters

object_type
stringRequired
values
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_DELETE_NOTE

This tool allows users to delete a specific note in attio by its id. it is implemented via delete https://api.attio.com/v2/notes/{note id} and handles note deletion by validating the provided note id. it complements attio create note functionality, providing complete note management capabilities within the attio platform.

Action Parameters

note_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_DELETE_RECORD

This tool allows you to delete a record from attio permanently. the deletion is irreversible, and the data will eventually be removed from the system.

Action Parameters

object_type
stringRequired
record_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_FIND_RECORD

This tool allows users to find a record in attio by either its unique id or by searching using unique attributes. it provides two methods: one for directly retrieving a record by its id with the get /v2/objects/{object}/records/{record id} endpoint, and another for searching by attributes using the post /v2/objects/{object}/records/query endpoint.

Action Parameters

attributes
object
limit
integerDefaults to 500
object_id
stringRequired
offset
integer
record_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_GET_OBJECT

This tool retrieves detailed information about a specific object type in attio, including all its attributes and their properties. this is useful for understanding what fields are available when creating or updating records of this type.

Action Parameters

object_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_LIST_LISTS

This tool retrieves all lists available in the attio workspace. the lists are returned sorted as they appear in the sidebar. this tool is essential for managing and navigating lists, and is a prerequisite for many list-related operations. it requires the list configuration:read permission scope.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_LIST_NOTES

This tool lists all notes associated with a specific record in attio. notes are returned in reverse chronological order (newest first).

Action Parameters

limit
integerDefaults to 50
parent_object
stringRequired
parent_record_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_LIST_OBJECTS

This tool retrieves a list of all available objects (both system-defined and user-defined) in the attio workspace. it makes a get request to the /v2/objects endpoint and returns a json response containing key metadata about each object, which is fundamental for understanding and accessing the workspace's structure.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_LIST_RECORDS

This tool lists records from a specific object type in attio. it provides simple pagination support and returns records in the order they were created. for complex filtering, use the findrecord action instead.

Action Parameters

limit
integerDefaults to 20
object_type
stringRequired
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: ATTIO_UPDATE_RECORD

This tool updates an existing record in attio for a specified object type (people, companies, deals, etc.). it uses patch to partially update only the provided fields, leaving other fields unchanged.

Action Parameters

object_type
stringRequired
record_id
stringRequired
values
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired