Attio

Learn how to use Attio with Composio

Overview

Enum

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
base_url
stringDefaults to https://api.attio.com

Actions

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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean