Attio

Use Attio in Sim to manage records for people, companies, and custom objects; work with lists, notes, tasks, and comments; and configure webhooks. Attio event triggers can start workflows when records or related resources change.

Connection guides: API keys.

OAuth scopes

Sim requests these scopes when someone connects an Attio account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

Use the block

Connect to Attio to manage CRM records (people, companies, custom objects), notes, tasks, lists, list entries, comments, workspace members, and webhooks.

Actions

Attio List Records

Query and list records for a given object type (e.g. people, companies)

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
filter	string	No	JSON filter object for querying records
sorts	string	No	JSON array of sort objects, e.g. [{"direction":"asc","attribute":"name"}]
limit	number	No	Maximum number of records to return (default 500)
offset	number	No	Number of records to skip for pagination

Output

Parameter	Type	Description
records	array	Array of Attio records
↳ id	object	The record identifier
↳ workspace_id	string	The workspace ID
↳ object_id	string	The object ID
↳ record_id	string	The record ID
↳ created_at	string	When the record was created
↳ web_url	string	URL to view the record in Attio
↳ values	json	The record attribute values
count	number	Number of records returned

Attio Get Record

Get a single record by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
recordId	string	Yes	The ID of the record to retrieve

Output

Parameter	Type	Description
record	object	An Attio record
↳ id	object	The record identifier
↳ workspace_id	string	The workspace ID
↳ object_id	string	The object ID
↳ record_id	string	The record ID
↳ created_at	string	When the record was created
↳ web_url	string	URL to view the record in Attio
↳ values	json	The record attribute values
recordId	string	The record ID
webUrl	string	URL to view the record in Attio

Attio Create Record

Create a new record in Attio for a given object type

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
values	string	Yes	JSON object of attribute values to set on the record

Output

Parameter	Type	Description
record	object	An Attio record
↳ id	object	The record identifier
↳ workspace_id	string	The workspace ID
↳ object_id	string	The object ID
↳ record_id	string	The record ID
↳ created_at	string	When the record was created
↳ web_url	string	URL to view the record in Attio
↳ values	json	The record attribute values
recordId	string	The ID of the created record
webUrl	string	URL to view the record in Attio

Attio Update Record

Update an existing record in Attio (appends multiselect values)

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
recordId	string	Yes	The ID of the record to update
values	string	Yes	JSON object of attribute values to update

Output

Parameter	Type	Description
record	object	An Attio record
↳ id	object	The record identifier
↳ workspace_id	string	The workspace ID
↳ object_id	string	The object ID
↳ record_id	string	The record ID
↳ created_at	string	When the record was created
↳ web_url	string	URL to view the record in Attio
↳ values	json	The record attribute values
recordId	string	The ID of the updated record
webUrl	string	URL to view the record in Attio

Attio Delete Record

Delete a record from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
recordId	string	Yes	The ID of the record to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the record was deleted

Attio Search Records

Fuzzy search for records across object types in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
query	string	Yes	The search query (max 256 characters)
objects	string	Yes	Comma-separated object slugs to search (e.g. people,companies)
limit	number	No	Maximum number of results (1-25, default 25)

Output

Parameter	Type	Description
results	array	Search results
↳ recordId	string	The record ID
↳ objectId	string	The object type ID
↳ objectSlug	string	The object type slug
↳ recordText	string	Display text for the record
↳ recordImage	string	Image URL for the record
count	number	Number of results returned

Attio Assert Record

Upsert a record in Attio — creates it if no match is found, updates it if a match exists

Inputs and outputs

Input

Parameter	Type	Required	Description
objectType	string	Yes	The object type slug (e.g. people, companies)
matchingAttribute	string	Yes	The attribute slug to match on for upsert (e.g. email_addresses for people, domains for companies)
values	string	Yes	JSON object of attribute values (e.g. {"email_addresses":[{"email_address":"test@example.com"}]})

Output

Parameter	Type	Description
record	object	The upserted record
↳ id	object	The record identifier
↳ workspace_id	string	The workspace ID
↳ object_id	string	The object ID
↳ record_id	string	The record ID
↳ created_at	string	When the record was created
↳ web_url	string	URL to view the record in Attio
↳ values	json	The record attribute values
recordId	string	The record ID
webUrl	string	URL to view the record in Attio

Attio List Notes

List notes in Attio, optionally filtered by parent record

Inputs and outputs

Input

Parameter	Type	Required	Description
parentObject	string	No	Object type slug to filter notes by (e.g. people, companies)
parentRecordId	string	No	Record ID to filter notes by
limit	number	No	Maximum number of notes to return (default 10, max 50)
offset	number	No	Number of notes to skip for pagination

Output

Parameter	Type	Description
notes	array	Array of notes
↳ noteId	string	The note ID
↳ parentObject	string	The parent object slug
↳ parentRecordId	string	The parent record ID
↳ title	string	The note title
↳ contentPlaintext	string	The note content as plaintext
↳ contentMarkdown	string	The note content as markdown
↳ meetingId	string	The linked meeting ID
↳ tags	array	Tags on the note
↳ type	string	The tag type (workspace-member or record)
↳ workspaceMemberId	string	The workspace member ID (present when type is workspace-member)
↳ object	string	The tagged object slug (present when type is record)
↳ recordId	string	The tagged record ID (present when type is record)
↳ createdByActor	object	The actor who created the note
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
↳ createdAt	string	When the note was created
count	number	Number of notes returned

Attio Get Note

Get a single note by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
noteId	string	Yes	The ID of the note to retrieve

Output

Parameter	Type	Description
noteId	string	The note ID
parentObject	string	The parent object slug
parentRecordId	string	The parent record ID
title	string	The note title
contentPlaintext	string	The note content as plaintext
contentMarkdown	string	The note content as markdown
meetingId	string	The linked meeting ID
tags	array	Tags on the note
↳ type	string	The tag type (workspace-member or record)
↳ workspaceMemberId	string	The workspace member ID (present when type is workspace-member)
↳ object	string	The tagged object slug (present when type is record)
↳ recordId	string	The tagged record ID (present when type is record)
createdByActor	object	The actor who created the note
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the note was created

Attio Create Note

Create a note on a record in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
parentObject	string	Yes	The parent object type slug (e.g. people, companies)
parentRecordId	string	Yes	The parent record ID to attach the note to
title	string	Yes	The note title
content	string	Yes	The note content
format	string	No	Content format: plaintext or markdown (default plaintext)
createdAt	string	No	Backdate the note creation time (ISO 8601 format)
meetingId	string	No	Associate the note with a meeting ID

Output

Parameter	Type	Description
noteId	string	The note ID
parentObject	string	The parent object slug
parentRecordId	string	The parent record ID
title	string	The note title
contentPlaintext	string	The note content as plaintext
contentMarkdown	string	The note content as markdown
meetingId	string	The linked meeting ID
tags	array	Tags on the note
↳ type	string	The tag type (workspace-member or record)
↳ workspaceMemberId	string	The workspace member ID (present when type is workspace-member)
↳ object	string	The tagged object slug (present when type is record)
↳ recordId	string	The tagged record ID (present when type is record)
createdByActor	object	The actor who created the note
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the note was created

Attio Delete Note

Delete a note from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
noteId	string	Yes	The ID of the note to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the note was deleted

Attio List Tasks

List tasks in Attio, optionally filtered by record, assignee, or completion status

Inputs and outputs

Input

Parameter	Type	Required	Description
linkedObject	string	No	Object type slug to filter tasks by (requires linkedRecordId)
linkedRecordId	string	No	Record ID to filter tasks by (requires linkedObject)
assignee	string	No	Assignee email or member ID to filter by
isCompleted	boolean	No	Filter by completion status
sort	string	No	Sort order: created_at:asc, created_at:desc, completed_at:asc, or completed_at:desc
limit	number	No	Maximum number of tasks to return (default 500)
offset	number	No	Number of tasks to skip for pagination

Output

Parameter	Type	Description
tasks	array	Array of tasks
↳ taskId	string	The task ID
↳ content	string	The task content
↳ deadlineAt	string	The task deadline
↳ isCompleted	boolean	Whether the task is completed
↳ completedAt	string	When the task was completed
↳ linkedRecords	array	Records linked to this task
↳ targetObjectId	string	The linked object ID
↳ targetRecordId	string	The linked record ID
↳ assignees	array	Task assignees
↳ type	string	The assignee actor type (e.g. workspace-member)
↳ id	string	The assignee actor ID
↳ createdByActor	object	The actor who created this task
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
↳ createdAt	string	When the task was created
count	number	Number of tasks returned

Attio Get Task

Get a single task by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
taskId	string	Yes	The ID of the task to retrieve

Output

Parameter	Type	Description
taskId	string	The task ID
content	string	The task content
deadlineAt	string	The task deadline
isCompleted	boolean	Whether the task is completed
completedAt	string	When the task was completed
linkedRecords	array	Records linked to this task
↳ targetObjectId	string	The linked object ID
↳ targetRecordId	string	The linked record ID
assignees	array	Task assignees
↳ type	string	The assignee actor type (e.g. workspace-member)
↳ id	string	The assignee actor ID
createdByActor	object	The actor who created this task
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the task was created

Attio Create Task

Create a task in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
content	string	Yes	The task content (max 2000 characters)
deadlineAt	string	No	Deadline in ISO 8601 format (e.g. 2024-12-01T15:00:00.000Z)
isCompleted	boolean	No	Whether the task is completed (default false)
linkedRecords	string	No	JSON array of linked records (e.g. [{"target_object":"people","target_record_id":"..."}])
assignees	string	No	JSON array of assignees (e.g. [{"referenced_actor_type":"workspace-member","referenced_actor_id":"..."}])

Output

Parameter	Type	Description
taskId	string	The task ID
content	string	The task content
deadlineAt	string	The task deadline
isCompleted	boolean	Whether the task is completed
completedAt	string	When the task was completed
linkedRecords	array	Records linked to this task
↳ targetObjectId	string	The linked object ID
↳ targetRecordId	string	The linked record ID
assignees	array	Task assignees
↳ type	string	The assignee actor type (e.g. workspace-member)
↳ id	string	The assignee actor ID
createdByActor	object	The actor who created this task
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the task was created

Attio Update Task

Update a task in Attio (deadline, completion status, linked records, assignees)

Inputs and outputs

Input

Parameter	Type	Required	Description
taskId	string	Yes	The ID of the task to update
deadlineAt	string	No	New deadline in ISO 8601 format
isCompleted	boolean	No	Whether the task is completed
linkedRecords	string	No	JSON array of linked records
assignees	string	No	JSON array of assignees

Output

Parameter	Type	Description
taskId	string	The task ID
content	string	The task content
deadlineAt	string	The task deadline
isCompleted	boolean	Whether the task is completed
completedAt	string	When the task was completed
linkedRecords	array	Records linked to this task
↳ targetObjectId	string	The linked object ID
↳ targetRecordId	string	The linked record ID
assignees	array	Task assignees
↳ type	string	The assignee actor type (e.g. workspace-member)
↳ id	string	The assignee actor ID
createdByActor	object	The actor who created this task
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the task was created

Attio Delete Task

Delete a task from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
taskId	string	Yes	The ID of the task to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the task was deleted

Attio List Objects

List all objects (system and custom) in the Attio workspace

Inputs and outputs

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
objects	array	Array of objects
↳ objectId	string	The object ID
↳ apiSlug	string	The API slug (e.g. people, companies)
↳ singularNoun	string	Singular display name
↳ pluralNoun	string	Plural display name
↳ createdAt	string	When the object was created
count	number	Number of objects returned

Attio Get Object

Get a single object by ID or slug

Inputs and outputs

Input

Parameter	Type	Required	Description
object	string	Yes	The object ID or slug (e.g. people, companies)

Output

Parameter	Type	Description
objectId	string	The object ID
apiSlug	string	The API slug (e.g. people, companies)
singularNoun	string	Singular display name
pluralNoun	string	Plural display name
createdAt	string	When the object was created

Attio Create Object

Create a custom object in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
apiSlug	string	Yes	The API slug for the object (e.g. projects)
singularNoun	string	Yes	Singular display name (e.g. Project)
pluralNoun	string	Yes	Plural display name (e.g. Projects)

Output

Parameter	Type	Description
objectId	string	The object ID
apiSlug	string	The API slug (e.g. people, companies)
singularNoun	string	Singular display name
pluralNoun	string	Plural display name
createdAt	string	When the object was created

Attio Update Object

Update a custom object in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
object	string	Yes	The object ID or slug to update
apiSlug	string	No	New API slug
singularNoun	string	No	New singular display name
pluralNoun	string	No	New plural display name

Output

Parameter	Type	Description
objectId	string	The object ID
apiSlug	string	The API slug (e.g. people, companies)
singularNoun	string	Singular display name
pluralNoun	string	Plural display name
createdAt	string	When the object was created

Attio List Lists

List all lists in the Attio workspace

Inputs and outputs

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
lists	array	Array of lists
↳ listId	string	The list ID
↳ apiSlug	string	The API slug for the list
↳ name	string	The list name
↳ parentObject	string	The parent object slug (e.g. people, companies)
↳ workspaceAccess	string	Workspace-level access (e.g. full-access, read-only)
↳ workspaceMemberAccess	json	Member-level access entries
↳ createdByActor	object	The actor who created the list
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
↳ createdAt	string	When the list was created
count	number	Number of lists returned

Attio Get List

Get a single list by ID or slug

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug

Output

Parameter	Type	Description
listId	string	The list ID
apiSlug	string	The API slug for the list
name	string	The list name
parentObject	string	The parent object slug (e.g. people, companies)
workspaceAccess	string	Workspace-level access (e.g. full-access, read-only)
workspaceMemberAccess	json	Member-level access entries
createdByActor	object	The actor who created the list
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the list was created

Attio Create List

Create a new list in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
name	string	Yes	The list name
apiSlug	string	No	The API slug for the list (auto-generated from name if omitted)
parentObject	string	Yes	The parent object slug (e.g. people, companies)
workspaceAccess	string	No	Workspace-level access: full-access, read-and-write, or read-only (omit for private)
workspaceMemberAccess	string	No	JSON array of member access entries, e.g. [{"workspace_member_id":"...","level":"read-and-write"}]

Output

Parameter	Type	Description
listId	string	The list ID
apiSlug	string	The API slug for the list
name	string	The list name
parentObject	string	The parent object slug (e.g. people, companies)
workspaceAccess	string	Workspace-level access (e.g. full-access, read-only)
workspaceMemberAccess	json	Member-level access entries
createdByActor	object	The actor who created the list
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the list was created

Attio Update List

Update a list in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug to update
name	string	No	New name for the list
apiSlug	string	No	New API slug for the list
workspaceAccess	string	No	New workspace-level access: full-access, read-and-write, or read-only (omit for private)
workspaceMemberAccess	string	No	JSON array of member access entries, e.g. [{"workspace_member_id":"...","level":"read-and-write"}]

Output

Parameter	Type	Description
listId	string	The list ID
apiSlug	string	The API slug for the list
name	string	The list name
parentObject	string	The parent object slug (e.g. people, companies)
workspaceAccess	string	Workspace-level access (e.g. full-access, read-only)
workspaceMemberAccess	json	Member-level access entries
createdByActor	object	The actor who created the list
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the list was created

Attio Query List Entries

Query entries in an Attio list with optional filter, sort, and pagination

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug
filter	string	No	JSON filter object for querying entries
sorts	string	No	JSON array of sort objects (e.g. [{"attribute":"created_at","direction":"desc"}])
limit	number	No	Maximum number of entries to return (default 500)
offset	number	No	Number of entries to skip for pagination

Output

Parameter	Type	Description
entries	array	Array of list entries
↳ entryId	string	The list entry ID
↳ listId	string	The list ID
↳ parentRecordId	string	The parent record ID
↳ parentObject	string	The parent object slug
↳ createdAt	string	When the entry was created
↳ entryValues	json	The entry attribute values (dynamic per list)
count	number	Number of entries returned

Attio Get List Entry

Get a single list entry by ID

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug
entryId	string	Yes	The entry ID

Output

Parameter	Type	Description
entryId	string	The list entry ID
listId	string	The list ID
parentRecordId	string	The parent record ID
parentObject	string	The parent object slug
createdAt	string	When the entry was created
entryValues	json	The entry attribute values (dynamic per list)

Attio Create List Entry

Add a record to an Attio list as a new entry

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug
parentRecordId	string	Yes	The record ID to add to the list
parentObject	string	Yes	The object type slug of the record (e.g. people, companies)
entryValues	string	No	JSON object of entry attribute values

Output

Parameter	Type	Description
entryId	string	The list entry ID
listId	string	The list ID
parentRecordId	string	The parent record ID
parentObject	string	The parent object slug
createdAt	string	When the entry was created
entryValues	json	The entry attribute values (dynamic per list)

Attio Update List Entry

Update entry attribute values on an Attio list entry (appends multiselect values)

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug
entryId	string	Yes	The entry ID to update
entryValues	string	Yes	JSON object of entry attribute values to update

Output

Parameter	Type	Description
entryId	string	The list entry ID
listId	string	The list ID
parentRecordId	string	The parent record ID
parentObject	string	The parent object slug
createdAt	string	When the entry was created
entryValues	json	The entry attribute values (dynamic per list)

Attio Delete List Entry

Remove an entry from an Attio list

Inputs and outputs

Input

Parameter	Type	Required	Description
list	string	Yes	The list ID or slug
entryId	string	Yes	The entry ID to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the entry was deleted

Attio List Members

List all workspace members in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
members	array	Array of workspace members
↳ memberId	string	The workspace member ID
↳ firstName	string	First name
↳ lastName	string	Last name
↳ avatarUrl	string	Avatar URL
↳ emailAddress	string	Email address
↳ accessLevel	string	Access level (admin, member, suspended)
↳ createdAt	string	When the member was added
count	number	Number of members returned

Attio Get Member

Get a single workspace member by ID

Inputs and outputs

Input

Parameter	Type	Required	Description
memberId	string	Yes	The workspace member ID

Output

Parameter	Type	Description
memberId	string	The workspace member ID
firstName	string	First name
lastName	string	Last name
avatarUrl	string	Avatar URL
emailAddress	string	Email address
accessLevel	string	Access level (admin, member, suspended)
createdAt	string	When the member was added

Attio Create Comment

Create a comment on a list entry in Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
content	string	Yes	The comment content
format	string	No	Content format: plaintext or markdown (default plaintext)
authorType	string	Yes	Author type (e.g. workspace-member)
authorId	string	Yes	Author workspace member ID
list	string	No	The list ID or slug the entry belongs to (used with entryId; omit if threadId or recordId is set)
entryId	string	No	The list entry ID to comment on (used with list; omit if threadId or recordId is set)
recordObject	string	No	The object ID or slug the record belongs to (used with recordId; omit if threadId or entryId is set)
recordId	string	No	The record ID to comment on directly (used with recordObject; omit if threadId or entryId is set)
threadId	string	No	Thread ID to reply to (omit to start a new thread on a record or list entry)
createdAt	string	No	Backdate the comment (ISO 8601 format)

Output

Parameter	Type	Description
commentId	string	The comment ID
threadId	string	The thread ID
contentPlaintext	string	The comment content as plaintext
author	object	The comment author
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
entry	object	The list entry this comment is on
↳ listId	string	The list ID
↳ entryId	string	The entry ID
record	object	The record this comment is on
↳ objectId	string	The object ID
↳ recordId	string	The record ID
resolvedAt	string	When the thread was resolved
resolvedBy	object	Who resolved the thread
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the comment was created

Attio Get Comment

Get a single comment by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
commentId	string	Yes	The comment ID

Output

Parameter	Type	Description
commentId	string	The comment ID
threadId	string	The thread ID
contentPlaintext	string	The comment content as plaintext
author	object	The comment author
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
entry	object	The list entry this comment is on
↳ listId	string	The list ID
↳ entryId	string	The entry ID
record	object	The record this comment is on
↳ objectId	string	The object ID
↳ recordId	string	The record ID
resolvedAt	string	When the thread was resolved
resolvedBy	object	Who resolved the thread
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
createdAt	string	When the comment was created

Attio Delete Comment

Delete a comment in Attio (if head of thread, deletes entire thread)

Inputs and outputs

Input

Parameter	Type	Required	Description
commentId	string	Yes	The comment ID to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the comment was deleted

Attio List Threads

List comment threads in Attio, optionally filtered by record or list entry

Inputs and outputs

Input

Parameter	Type	Required	Description
recordId	string	No	Filter by record ID (requires object)
object	string	No	Object slug to filter by (requires recordId)
entryId	string	No	Filter by list entry ID (requires list)
list	string	No	List ID or slug to filter by (requires entryId)
limit	number	No	Maximum number of threads to return (max 50)
offset	number	No	Number of threads to skip for pagination

Output

Parameter	Type	Description
threads	array	Array of threads
↳ threadId	string	The thread ID
↳ comments	array	Comments in the thread
↳ commentId	string	The comment ID
↳ contentPlaintext	string	Comment content
↳ author	object	Comment author
↳ type	string	Actor type
↳ id	string	Actor ID
↳ createdAt	string	When the comment was created
↳ createdAt	string	When the thread was created
count	number	Number of threads returned

Attio Get Thread

Get a single comment thread by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
threadId	string	Yes	The thread ID

Output

Parameter	Type	Description
threadId	string	The thread ID
comments	array	Comments in the thread
↳ commentId	string	The comment ID
↳ contentPlaintext	string	Comment content as plaintext
↳ author	object	The comment author
↳ type	string	The actor type (e.g. workspace-member, api-token, system)
↳ id	string	The actor ID
↳ createdAt	string	When the comment was created
createdAt	string	When the thread was created

Attio List Webhooks

List all webhooks in the Attio workspace

Inputs and outputs

Input

Parameter	Type	Required	Description
limit	number	No	Maximum number of webhooks to return
offset	number	No	Number of webhooks to skip for pagination

Output

Parameter	Type	Description
webhooks	array	Array of webhooks
↳ webhookId	string	The webhook ID
↳ targetUrl	string	The webhook target URL
↳ subscriptions	array	Event subscriptions
↳ eventType	string	The event type (e.g. record.created)
↳ filter	json	Optional event filter
↳ status	string	Webhook status (active, degraded, inactive)
↳ createdAt	string	When the webhook was created
count	number	Number of webhooks returned

Attio Get Webhook

Get a single webhook by ID from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
webhookId	string	Yes	The webhook ID

Output

Parameter	Type	Description
webhookId	string	The webhook ID
targetUrl	string	The webhook target URL
subscriptions	array	Event subscriptions
↳ eventType	string	The event type (e.g. record.created)
↳ filter	json	Optional event filter
status	string	Webhook status (active, degraded, inactive)
createdAt	string	When the webhook was created

Attio Create Webhook

Create a webhook in Attio to receive event notifications

Inputs and outputs

Input

Parameter	Type	Required	Description
targetUrl	string	Yes	The HTTPS URL to receive webhook events
subscriptions	string	Yes	JSON array of subscriptions (e.g. [{"event_type":"record.created","filter":{"object_id":"..."}}])

Output

Parameter	Type	Description
webhookId	string	The webhook ID
targetUrl	string	The webhook target URL
subscriptions	array	Event subscriptions
↳ eventType	string	The event type (e.g. record.created)
↳ filter	json	Optional event filter
status	string	Webhook status (active, degraded, inactive)
createdAt	string	When the webhook was created
secret	string	The webhook signing secret (only returned on creation)

Attio Update Webhook

Update a webhook in Attio (target URL and/or subscriptions)

Inputs and outputs

Input

Parameter	Type	Required	Description
webhookId	string	Yes	The webhook ID to update
targetUrl	string	No	HTTPS target URL for webhook delivery
subscriptions	string	No	JSON array of subscriptions, e.g. [{"event_type":"note.created"}]

Output

Parameter	Type	Description
webhookId	string	The webhook ID
targetUrl	string	The webhook target URL
subscriptions	array	Event subscriptions
↳ eventType	string	The event type (e.g. record.created)
↳ filter	json	Optional event filter
status	string	Webhook status (active, degraded, inactive)
createdAt	string	When the webhook was created

Attio Delete Webhook

Delete a webhook from Attio

Inputs and outputs

Input

Parameter	Type	Required	Description
webhookId	string	Yes	The webhook ID to delete

Output

Parameter	Type	Description
deleted	boolean	Whether the webhook was deleted

Attio List Attributes

List the attributes (schema fields) defined on an Attio object or list

Inputs and outputs

Input

Parameter	Type	Required	Description
target	string	Yes	Whether the attributes belong to an object or a list: objects or lists
identifier	string	Yes	The object or list ID or slug (e.g. people, companies)
limit	number	No	Maximum number of attributes to return
offset	number	No	Number of attributes to skip for pagination
showArchived	boolean	No	Whether to include archived attributes (default false)

Output

Parameter	Type	Description
attributes	array	Array of attributes
↳ attributeId	string	The attribute ID
↳ title	string	The attribute display title
↳ apiSlug	string	The attribute API slug
↳ description	string	The attribute description
↳ type	string	The attribute value type (e.g. text, number, select, record-reference)
↳ isSystemAttribute	boolean	Whether this is a built-in system attribute
↳ isWritable	boolean	Whether the attribute can be written to
↳ isRequired	boolean	Whether new records must provide a value
↳ isUnique	boolean	Whether the attribute enforces uniqueness
↳ isMultiselect	boolean	Whether the attribute supports multiple values
↳ isDefaultValueEnabled	boolean	Whether this attribute has a default value enabled
↳ isArchived	boolean	Whether the attribute is archived
↳ defaultValue	json	The default value for this attribute, if enabled
↳ relationship	json	The related attribute, if this attribute is part of a relationship
↳ config	json	Type-dependent attribute configuration
↳ createdAt	string	When the attribute was created
count	number	Number of attributes returned

Attio Get Attribute

Get a single attribute (schema field) on an Attio object or list

Inputs and outputs

Input

Parameter	Type	Required	Description
target	string	Yes	Whether the attribute belongs to an object or a list: objects or lists
identifier	string	Yes	The object or list ID or slug (e.g. people, companies)
attribute	string	Yes	The attribute ID or slug

Output

Parameter	Type	Description
attributeId	string	The attribute ID
title	string	The attribute display title
apiSlug	string	The attribute API slug
description	string	The attribute description
type	string	The attribute value type (e.g. text, number, select, record-reference)
isSystemAttribute	boolean	Whether this is a built-in system attribute
isWritable	boolean	Whether the attribute can be written to
isRequired	boolean	Whether new records must provide a value
isUnique	boolean	Whether the attribute enforces uniqueness
isMultiselect	boolean	Whether the attribute supports multiple values
isDefaultValueEnabled	boolean	Whether this attribute has a default value enabled
isArchived	boolean	Whether the attribute is archived
defaultValue	json	The default value for this attribute, if enabled
relationship	json	The related attribute, if this attribute is part of a relationship
config	json	Type-dependent attribute configuration
createdAt	string	When the attribute was created

Attio Create Attribute

Create a new attribute (schema field) on an Attio object or list

Inputs and outputs

Input

Parameter	Type	Required	Description
target	string	Yes	Whether to create the attribute on an object or a list: objects or lists
identifier	string	Yes	The object or list ID or slug (e.g. people, companies)
title	string	Yes	The attribute display title
apiSlug	string	Yes	The attribute API slug (unique, snake_case)
type	string	Yes	The attribute value type (e.g. text, number, checkbox, currency, date, timestamp, rating, status, select, record-reference, actor-reference, location, domain, email-address, phone-number)
description	string	No	A description of the attribute
isRequired	boolean	No	Whether new records must provide a value (default false)
isUnique	boolean	No	Whether the attribute enforces uniqueness on new data (default false)
isMultiselect	boolean	No	Whether the attribute supports multiple values (default false)
config	string	No	JSON object of type-dependent configuration (e.g. currency or record-reference settings)

Output

Parameter	Type	Description
attributeId	string	The attribute ID
title	string	The attribute display title
apiSlug	string	The attribute API slug
description	string	The attribute description
type	string	The attribute value type (e.g. text, number, select, record-reference)
isSystemAttribute	boolean	Whether this is a built-in system attribute
isWritable	boolean	Whether the attribute can be written to
isRequired	boolean	Whether new records must provide a value
isUnique	boolean	Whether the attribute enforces uniqueness
isMultiselect	boolean	Whether the attribute supports multiple values
isDefaultValueEnabled	boolean	Whether this attribute has a default value enabled
isArchived	boolean	Whether the attribute is archived
defaultValue	json	The default value for this attribute, if enabled
relationship	json	The related attribute, if this attribute is part of a relationship
config	json	Type-dependent attribute configuration
createdAt	string	When the attribute was created

Attio Update Attribute

Update an attribute (schema field) on an Attio object or list

Inputs and outputs

Input

Parameter	Type	Required	Description
target	string	Yes	Whether the attribute belongs to an object or a list: objects or lists
identifier	string	Yes	The object or list ID or slug (e.g. people, companies)
attribute	string	Yes	The attribute ID or slug to update
title	string	No	New attribute display title
apiSlug	string	No	New attribute API slug
description	string	No	New attribute description
isRequired	boolean	No	Whether new records must provide a value
isUnique	boolean	No	Whether the attribute enforces uniqueness on new data
isArchived	boolean	No	Archive or unarchive the attribute
config	string	No	JSON object of type-dependent configuration

Output

Parameter	Type	Description
attributeId	string	The attribute ID
title	string	The attribute display title
apiSlug	string	The attribute API slug
description	string	The attribute description
type	string	The attribute value type (e.g. text, number, select, record-reference)
isSystemAttribute	boolean	Whether this is a built-in system attribute
isWritable	boolean	Whether the attribute can be written to
isRequired	boolean	Whether new records must provide a value
isUnique	boolean	Whether the attribute enforces uniqueness
isMultiselect	boolean	Whether the attribute supports multiple values
isDefaultValueEnabled	boolean	Whether this attribute has a default value enabled
isArchived	boolean	Whether the attribute is archived
defaultValue	json	The default value for this attribute, if enabled
relationship	json	The related attribute, if this attribute is part of a relationship
config	json	Type-dependent attribute configuration
createdAt	string	When the attribute was created

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Attio Comment Created

Trigger workflow when a new comment is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
threadId	string	The thread ID
commentId	string	The comment ID
objectId	string	The object type ID
recordId	string	The record ID
listId	string	The list ID (if comment is on a list entry)
entryId	string	The list entry ID (if comment is on a list entry)

Attio Comment Deleted

Trigger workflow when a comment is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
threadId	string	The thread ID
commentId	string	The comment ID
objectId	string	The object type ID
recordId	string	The record ID
listId	string	The list ID (if comment is on a list entry)
entryId	string	The list entry ID (if comment is on a list entry)

Attio Comment Resolved

Trigger workflow when a comment thread is resolved in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
threadId	string	The thread ID
commentId	string	The comment ID
objectId	string	The object type ID
recordId	string	The record ID
listId	string	The list ID (if comment is on a list entry)
entryId	string	The list entry ID (if comment is on a list entry)

Attio Comment Unresolved

Trigger workflow when a comment thread is unresolved in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
threadId	string	The thread ID
commentId	string	The comment ID
objectId	string	The object type ID
recordId	string	The record ID
listId	string	The list ID (if comment is on a list entry)
entryId	string	The list entry ID (if comment is on a list entry)

Attio List Created

Trigger workflow when a list is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID

Attio List Deleted

Trigger workflow when a list is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID

Attio List Entry Created

Trigger workflow when a new list entry is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID
entryId	string	The list entry ID

Attio List Entry Deleted

Trigger workflow when a list entry is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID
entryId	string	The list entry ID

Attio List Entry Updated

Trigger workflow when a list entry is updated in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID
entryId	string	The list entry ID
attributeId	string	The ID of the attribute that was updated on the list entry

Attio List Updated

Trigger workflow when a list is updated in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
listId	string	The list ID

Attio Note Created

Trigger workflow when a new note is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
noteId	string	The note ID
parentObjectId	string	The parent object type ID
parentRecordId	string	The parent record ID

Attio Note Deleted

Trigger workflow when a note is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
noteId	string	The note ID
parentObjectId	string	The parent object type ID
parentRecordId	string	The parent record ID

Attio Note Updated

Trigger workflow when a note is updated in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
noteId	string	The note ID
parentObjectId	string	The parent object type ID
parentRecordId	string	The parent record ID

Attio Record Created

Trigger workflow when a new record is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
objectId	string	The object type ID (e.g. people, companies)
recordId	string	The record ID

Attio Record Deleted

Trigger workflow when a record is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
objectId	string	The object type ID (e.g. people, companies)
recordId	string	The record ID

Attio Record Merged

Trigger workflow when two records are merged in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
objectId	string	The object type ID of the surviving record
recordId	string	The surviving record ID after merge
duplicateObjectId	string	The object type ID of the merged-away record
duplicateRecordId	string	The record ID that was merged away

Attio Record Updated

Trigger workflow when a record is updated in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
objectId	string	The object type ID (e.g. people, companies)
recordId	string	The record ID
attributeId	string	The ID of the attribute that was updated on the record

Attio Task Created

Trigger workflow when a new task is created in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
taskId	string	The task ID

Attio Task Deleted

Trigger workflow when a task is deleted in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
taskId	string	The task ID

Attio Task Updated

Trigger workflow when a task is updated in Attio

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
taskId	string	The task ID

Attio Webhook (All Events)

Trigger workflow on any Attio webhook event

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
id	json	The event ID object containing resource identifiers
parentObjectId	string	The parent object type ID (if applicable)
parentRecordId	string	The parent record ID (if applicable)

Attio Workspace Member Created

Trigger workflow when a new member is added to the Attio workspace

Configuration and outputs

Configuration

Parameter	Type	Required	Description
triggerCredentials	string	Yes	Attio Account

Output

Parameter	Type	Description
eventType	string	The type of event (e.g. record.created, note.created)
workspaceId	string	The workspace ID
workspaceMemberId	string	The workspace member ID