Skip to content
Try for free
On this page

Integrations

Attio

Manage records, notes, tasks, lists, comments, and more in Attio CRM

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.

SettingValue
Redirect URI<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/attio
Environment variablesATTIO_CLIENT_ID, ATTIO_CLIENT_SECRET
ScopeDescription
record_permission:read-writeRead and write CRM records
object_configuration:read-writeRead and manage object schemas
list_configuration:read-writeRead and manage list configurations
list_entry:read-writeRead and write list entries
note:read-writeRead and write notes
task:read-writeRead and write tasks
comment:read-writeRead and write comments and threads
user_management:readView workspace members
webhook:read-writeManage webhooks

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

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
filterstringNoJSON filter object for querying records
sortsstringNoJSON array of sort objects, e.g. [{"direction":"asc","attribute":"name"}]
limitnumberNoMaximum number of records to return (default 500)
offsetnumberNoNumber of records to skip for pagination

Output

ParameterTypeDescription
recordsarrayArray of Attio records
↳ idobjectThe record identifier
↳ workspace_idstringThe workspace ID
↳ object_idstringThe object ID
↳ record_idstringThe record ID
↳ created_atstringWhen the record was created
↳ web_urlstringURL to view the record in Attio
↳ valuesjsonThe record attribute values
countnumberNumber of records returned

Attio Get Record

Get a single record by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
recordIdstringYesThe ID of the record to retrieve

Output

ParameterTypeDescription
recordobjectAn Attio record
↳ idobjectThe record identifier
↳ workspace_idstringThe workspace ID
↳ object_idstringThe object ID
↳ record_idstringThe record ID
↳ created_atstringWhen the record was created
↳ web_urlstringURL to view the record in Attio
↳ valuesjsonThe record attribute values
recordIdstringThe record ID
webUrlstringURL to view the record in Attio

Attio Create Record

Create a new record in Attio for a given object type

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
valuesstringYesJSON object of attribute values to set on the record

Output

ParameterTypeDescription
recordobjectAn Attio record
↳ idobjectThe record identifier
↳ workspace_idstringThe workspace ID
↳ object_idstringThe object ID
↳ record_idstringThe record ID
↳ created_atstringWhen the record was created
↳ web_urlstringURL to view the record in Attio
↳ valuesjsonThe record attribute values
recordIdstringThe ID of the created record
webUrlstringURL to view the record in Attio

Attio Update Record

Update an existing record in Attio (appends multiselect values)

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
recordIdstringYesThe ID of the record to update
valuesstringYesJSON object of attribute values to update

Output

ParameterTypeDescription
recordobjectAn Attio record
↳ idobjectThe record identifier
↳ workspace_idstringThe workspace ID
↳ object_idstringThe object ID
↳ record_idstringThe record ID
↳ created_atstringWhen the record was created
↳ web_urlstringURL to view the record in Attio
↳ valuesjsonThe record attribute values
recordIdstringThe ID of the updated record
webUrlstringURL to view the record in Attio

Attio Delete Record

Delete a record from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
recordIdstringYesThe ID of the record to delete

Output

ParameterTypeDescription
deletedbooleanWhether the record was deleted

Attio Search Records

Fuzzy search for records across object types in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
querystringYesThe search query (max 256 characters)
objectsstringYesComma-separated object slugs to search (e.g. people,companies)
limitnumberNoMaximum number of results (1-25, default 25)

Output

ParameterTypeDescription
resultsarraySearch results
↳ recordIdstringThe record ID
↳ objectIdstringThe object type ID
↳ objectSlugstringThe object type slug
↳ recordTextstringDisplay text for the record
↳ recordImagestringImage URL for the record
countnumberNumber 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

ParameterTypeRequiredDescription
objectTypestringYesThe object type slug (e.g. people, companies)
matchingAttributestringYesThe attribute slug to match on for upsert (e.g. email_addresses for people, domains for companies)
valuesstringYesJSON object of attribute values (e.g. {"email_addresses":[{"email_address":"test@example.com"}]})

Output

ParameterTypeDescription
recordobjectThe upserted record
↳ idobjectThe record identifier
↳ workspace_idstringThe workspace ID
↳ object_idstringThe object ID
↳ record_idstringThe record ID
↳ created_atstringWhen the record was created
↳ web_urlstringURL to view the record in Attio
↳ valuesjsonThe record attribute values
recordIdstringThe record ID
webUrlstringURL to view the record in Attio

Attio List Notes

List notes in Attio, optionally filtered by parent record

Inputs and outputs

Input

ParameterTypeRequiredDescription
parentObjectstringNoObject type slug to filter notes by (e.g. people, companies)
parentRecordIdstringNoRecord ID to filter notes by
limitnumberNoMaximum number of notes to return (default 10, max 50)
offsetnumberNoNumber of notes to skip for pagination

Output

ParameterTypeDescription
notesarrayArray of notes
↳ noteIdstringThe note ID
↳ parentObjectstringThe parent object slug
↳ parentRecordIdstringThe parent record ID
↳ titlestringThe note title
↳ contentPlaintextstringThe note content as plaintext
↳ contentMarkdownstringThe note content as markdown
↳ meetingIdstringThe linked meeting ID
↳ tagsarrayTags on the note
↳ typestringThe tag type (workspace-member or record)
↳ workspaceMemberIdstringThe workspace member ID (present when type is workspace-member)
↳ objectstringThe tagged object slug (present when type is record)
↳ recordIdstringThe tagged record ID (present when type is record)
↳ createdByActorobjectThe actor who created the note
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
↳ createdAtstringWhen the note was created
countnumberNumber of notes returned

Attio Get Note

Get a single note by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
noteIdstringYesThe ID of the note to retrieve

Output

ParameterTypeDescription
noteIdstringThe note ID
parentObjectstringThe parent object slug
parentRecordIdstringThe parent record ID
titlestringThe note title
contentPlaintextstringThe note content as plaintext
contentMarkdownstringThe note content as markdown
meetingIdstringThe linked meeting ID
tagsarrayTags on the note
↳ typestringThe tag type (workspace-member or record)
↳ workspaceMemberIdstringThe workspace member ID (present when type is workspace-member)
↳ objectstringThe tagged object slug (present when type is record)
↳ recordIdstringThe tagged record ID (present when type is record)
createdByActorobjectThe actor who created the note
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the note was created

Attio Create Note

Create a note on a record in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
parentObjectstringYesThe parent object type slug (e.g. people, companies)
parentRecordIdstringYesThe parent record ID to attach the note to
titlestringYesThe note title
contentstringYesThe note content
formatstringNoContent format: plaintext or markdown (default plaintext)
createdAtstringNoBackdate the note creation time (ISO 8601 format)
meetingIdstringNoAssociate the note with a meeting ID

Output

ParameterTypeDescription
noteIdstringThe note ID
parentObjectstringThe parent object slug
parentRecordIdstringThe parent record ID
titlestringThe note title
contentPlaintextstringThe note content as plaintext
contentMarkdownstringThe note content as markdown
meetingIdstringThe linked meeting ID
tagsarrayTags on the note
↳ typestringThe tag type (workspace-member or record)
↳ workspaceMemberIdstringThe workspace member ID (present when type is workspace-member)
↳ objectstringThe tagged object slug (present when type is record)
↳ recordIdstringThe tagged record ID (present when type is record)
createdByActorobjectThe actor who created the note
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the note was created

Attio Delete Note

Delete a note from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
noteIdstringYesThe ID of the note to delete

Output

ParameterTypeDescription
deletedbooleanWhether the note was deleted

Attio List Tasks

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
linkedObjectstringNoObject type slug to filter tasks by (requires linkedRecordId)
linkedRecordIdstringNoRecord ID to filter tasks by (requires linkedObject)
assigneestringNoAssignee email or member ID to filter by
isCompletedbooleanNoFilter by completion status
sortstringNoSort order: created_at:asc, created_at:desc, completed_at:asc, or completed_at:desc
limitnumberNoMaximum number of tasks to return (default 500)
offsetnumberNoNumber of tasks to skip for pagination

Output

ParameterTypeDescription
tasksarrayArray of tasks
↳ taskIdstringThe task ID
↳ contentstringThe task content
↳ deadlineAtstringThe task deadline
↳ isCompletedbooleanWhether the task is completed
↳ completedAtstringWhen the task was completed
↳ linkedRecordsarrayRecords linked to this task
↳ targetObjectIdstringThe linked object ID
↳ targetRecordIdstringThe linked record ID
↳ assigneesarrayTask assignees
↳ typestringThe assignee actor type (e.g. workspace-member)
↳ idstringThe assignee actor ID
↳ createdByActorobjectThe actor who created this task
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
↳ createdAtstringWhen the task was created
countnumberNumber of tasks returned

Attio Get Task

Get a single task by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task to retrieve

Output

ParameterTypeDescription
taskIdstringThe task ID
contentstringThe task content
deadlineAtstringThe task deadline
isCompletedbooleanWhether the task is completed
completedAtstringWhen the task was completed
linkedRecordsarrayRecords linked to this task
↳ targetObjectIdstringThe linked object ID
↳ targetRecordIdstringThe linked record ID
assigneesarrayTask assignees
↳ typestringThe assignee actor type (e.g. workspace-member)
↳ idstringThe assignee actor ID
createdByActorobjectThe actor who created this task
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the task was created

Attio Create Task

Create a task in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
contentstringYesThe task content (max 2000 characters)
deadlineAtstringNoDeadline in ISO 8601 format (e.g. 2024-12-01T15:00:00.000Z)
isCompletedbooleanNoWhether the task is completed (default false)
linkedRecordsstringNoJSON array of linked records (e.g. [{"target_object":"people","target_record_id":"..."}])
assigneesstringNoJSON array of assignees (e.g. [{"referenced_actor_type":"workspace-member","referenced_actor_id":"..."}])

Output

ParameterTypeDescription
taskIdstringThe task ID
contentstringThe task content
deadlineAtstringThe task deadline
isCompletedbooleanWhether the task is completed
completedAtstringWhen the task was completed
linkedRecordsarrayRecords linked to this task
↳ targetObjectIdstringThe linked object ID
↳ targetRecordIdstringThe linked record ID
assigneesarrayTask assignees
↳ typestringThe assignee actor type (e.g. workspace-member)
↳ idstringThe assignee actor ID
createdByActorobjectThe actor who created this task
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the task was created

Attio Update Task

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task to update
deadlineAtstringNoNew deadline in ISO 8601 format
isCompletedbooleanNoWhether the task is completed
linkedRecordsstringNoJSON array of linked records
assigneesstringNoJSON array of assignees

Output

ParameterTypeDescription
taskIdstringThe task ID
contentstringThe task content
deadlineAtstringThe task deadline
isCompletedbooleanWhether the task is completed
completedAtstringWhen the task was completed
linkedRecordsarrayRecords linked to this task
↳ targetObjectIdstringThe linked object ID
↳ targetRecordIdstringThe linked record ID
assigneesarrayTask assignees
↳ typestringThe assignee actor type (e.g. workspace-member)
↳ idstringThe assignee actor ID
createdByActorobjectThe actor who created this task
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the task was created

Attio Delete Task

Delete a task from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task to delete

Output

ParameterTypeDescription
deletedbooleanWhether the task was deleted

Attio List Objects

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

Inputs and outputs

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
objectsarrayArray of objects
↳ objectIdstringThe object ID
↳ apiSlugstringThe API slug (e.g. people, companies)
↳ singularNounstringSingular display name
↳ pluralNounstringPlural display name
↳ createdAtstringWhen the object was created
countnumberNumber of objects returned

Attio Get Object

Get a single object by ID or slug

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectstringYesThe object ID or slug (e.g. people, companies)

Output

ParameterTypeDescription
objectIdstringThe object ID
apiSlugstringThe API slug (e.g. people, companies)
singularNounstringSingular display name
pluralNounstringPlural display name
createdAtstringWhen the object was created

Attio Create Object

Create a custom object in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
apiSlugstringYesThe API slug for the object (e.g. projects)
singularNounstringYesSingular display name (e.g. Project)
pluralNounstringYesPlural display name (e.g. Projects)

Output

ParameterTypeDescription
objectIdstringThe object ID
apiSlugstringThe API slug (e.g. people, companies)
singularNounstringSingular display name
pluralNounstringPlural display name
createdAtstringWhen the object was created

Attio Update Object

Update a custom object in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
objectstringYesThe object ID or slug to update
apiSlugstringNoNew API slug
singularNounstringNoNew singular display name
pluralNounstringNoNew plural display name

Output

ParameterTypeDescription
objectIdstringThe object ID
apiSlugstringThe API slug (e.g. people, companies)
singularNounstringSingular display name
pluralNounstringPlural display name
createdAtstringWhen the object was created

Attio List Lists

List all lists in the Attio workspace

Inputs and outputs

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
listsarrayArray of lists
↳ listIdstringThe list ID
↳ apiSlugstringThe API slug for the list
↳ namestringThe list name
↳ parentObjectstringThe parent object slug (e.g. people, companies)
↳ workspaceAccessstringWorkspace-level access (e.g. full-access, read-only)
↳ workspaceMemberAccessjsonMember-level access entries
↳ createdByActorobjectThe actor who created the list
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
↳ createdAtstringWhen the list was created
countnumberNumber of lists returned

Attio Get List

Get a single list by ID or slug

Inputs and outputs

Input

ParameterTypeRequiredDescription
liststringYesThe list ID or slug

Output

ParameterTypeDescription
listIdstringThe list ID
apiSlugstringThe API slug for the list
namestringThe list name
parentObjectstringThe parent object slug (e.g. people, companies)
workspaceAccessstringWorkspace-level access (e.g. full-access, read-only)
workspaceMemberAccessjsonMember-level access entries
createdByActorobjectThe actor who created the list
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the list was created

Attio Create List

Create a new list in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
namestringYesThe list name
apiSlugstringNoThe API slug for the list (auto-generated from name if omitted)
parentObjectstringYesThe parent object slug (e.g. people, companies)
workspaceAccessstringNoWorkspace-level access: full-access, read-and-write, or read-only (omit for private)
workspaceMemberAccessstringNoJSON array of member access entries, e.g. [{"workspace_member_id":"...","level":"read-and-write"}]

Output

ParameterTypeDescription
listIdstringThe list ID
apiSlugstringThe API slug for the list
namestringThe list name
parentObjectstringThe parent object slug (e.g. people, companies)
workspaceAccessstringWorkspace-level access (e.g. full-access, read-only)
workspaceMemberAccessjsonMember-level access entries
createdByActorobjectThe actor who created the list
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the list was created

Attio Update List

Update a list in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
liststringYesThe list ID or slug to update
namestringNoNew name for the list
apiSlugstringNoNew API slug for the list
workspaceAccessstringNoNew workspace-level access: full-access, read-and-write, or read-only (omit for private)
workspaceMemberAccessstringNoJSON array of member access entries, e.g. [{"workspace_member_id":"...","level":"read-and-write"}]

Output

ParameterTypeDescription
listIdstringThe list ID
apiSlugstringThe API slug for the list
namestringThe list name
parentObjectstringThe parent object slug (e.g. people, companies)
workspaceAccessstringWorkspace-level access (e.g. full-access, read-only)
workspaceMemberAccessjsonMember-level access entries
createdByActorobjectThe actor who created the list
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the list was created

Attio Query List Entries

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
liststringYesThe list ID or slug
filterstringNoJSON filter object for querying entries
sortsstringNoJSON array of sort objects (e.g. [{"attribute":"created_at","direction":"desc"}])
limitnumberNoMaximum number of entries to return (default 500)
offsetnumberNoNumber of entries to skip for pagination

Output

ParameterTypeDescription
entriesarrayArray of list entries
↳ entryIdstringThe list entry ID
↳ listIdstringThe list ID
↳ parentRecordIdstringThe parent record ID
↳ parentObjectstringThe parent object slug
↳ createdAtstringWhen the entry was created
↳ entryValuesjsonThe entry attribute values (dynamic per list)
countnumberNumber of entries returned

Attio Get List Entry

Get a single list entry by ID

Inputs and outputs

Input

ParameterTypeRequiredDescription
liststringYesThe list ID or slug
entryIdstringYesThe entry ID

Output

ParameterTypeDescription
entryIdstringThe list entry ID
listIdstringThe list ID
parentRecordIdstringThe parent record ID
parentObjectstringThe parent object slug
createdAtstringWhen the entry was created
entryValuesjsonThe 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

ParameterTypeRequiredDescription
liststringYesThe list ID or slug
parentRecordIdstringYesThe record ID to add to the list
parentObjectstringYesThe object type slug of the record (e.g. people, companies)
entryValuesstringNoJSON object of entry attribute values

Output

ParameterTypeDescription
entryIdstringThe list entry ID
listIdstringThe list ID
parentRecordIdstringThe parent record ID
parentObjectstringThe parent object slug
createdAtstringWhen the entry was created
entryValuesjsonThe 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

ParameterTypeRequiredDescription
liststringYesThe list ID or slug
entryIdstringYesThe entry ID to update
entryValuesstringYesJSON object of entry attribute values to update

Output

ParameterTypeDescription
entryIdstringThe list entry ID
listIdstringThe list ID
parentRecordIdstringThe parent record ID
parentObjectstringThe parent object slug
createdAtstringWhen the entry was created
entryValuesjsonThe entry attribute values (dynamic per list)

Attio Delete List Entry

Remove an entry from an Attio list

Inputs and outputs

Input

ParameterTypeRequiredDescription
liststringYesThe list ID or slug
entryIdstringYesThe entry ID to delete

Output

ParameterTypeDescription
deletedbooleanWhether the entry was deleted

Attio List Members

List all workspace members in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
membersarrayArray of workspace members
↳ memberIdstringThe workspace member ID
↳ firstNamestringFirst name
↳ lastNamestringLast name
↳ avatarUrlstringAvatar URL
↳ emailAddressstringEmail address
↳ accessLevelstringAccess level (admin, member, suspended)
↳ createdAtstringWhen the member was added
countnumberNumber of members returned

Attio Get Member

Get a single workspace member by ID

Inputs and outputs

Input

ParameterTypeRequiredDescription
memberIdstringYesThe workspace member ID

Output

ParameterTypeDescription
memberIdstringThe workspace member ID
firstNamestringFirst name
lastNamestringLast name
avatarUrlstringAvatar URL
emailAddressstringEmail address
accessLevelstringAccess level (admin, member, suspended)
createdAtstringWhen the member was added

Attio Create Comment

Create a comment on a list entry in Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
contentstringYesThe comment content
formatstringNoContent format: plaintext or markdown (default plaintext)
authorTypestringYesAuthor type (e.g. workspace-member)
authorIdstringYesAuthor workspace member ID
liststringNoThe list ID or slug the entry belongs to (used with entryId; omit if threadId or recordId is set)
entryIdstringNoThe list entry ID to comment on (used with list; omit if threadId or recordId is set)
recordObjectstringNoThe object ID or slug the record belongs to (used with recordId; omit if threadId or entryId is set)
recordIdstringNoThe record ID to comment on directly (used with recordObject; omit if threadId or entryId is set)
threadIdstringNoThread ID to reply to (omit to start a new thread on a record or list entry)
createdAtstringNoBackdate the comment (ISO 8601 format)

Output

ParameterTypeDescription
commentIdstringThe comment ID
threadIdstringThe thread ID
contentPlaintextstringThe comment content as plaintext
authorobjectThe comment author
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
entryobjectThe list entry this comment is on
↳ listIdstringThe list ID
↳ entryIdstringThe entry ID
recordobjectThe record this comment is on
↳ objectIdstringThe object ID
↳ recordIdstringThe record ID
resolvedAtstringWhen the thread was resolved
resolvedByobjectWho resolved the thread
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the comment was created

Attio Get Comment

Get a single comment by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
commentIdstringYesThe comment ID

Output

ParameterTypeDescription
commentIdstringThe comment ID
threadIdstringThe thread ID
contentPlaintextstringThe comment content as plaintext
authorobjectThe comment author
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
entryobjectThe list entry this comment is on
↳ listIdstringThe list ID
↳ entryIdstringThe entry ID
recordobjectThe record this comment is on
↳ objectIdstringThe object ID
↳ recordIdstringThe record ID
resolvedAtstringWhen the thread was resolved
resolvedByobjectWho resolved the thread
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
createdAtstringWhen the comment was created

Attio Delete Comment

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
commentIdstringYesThe comment ID to delete

Output

ParameterTypeDescription
deletedbooleanWhether the comment was deleted

Attio List Threads

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
recordIdstringNoFilter by record ID (requires object)
objectstringNoObject slug to filter by (requires recordId)
entryIdstringNoFilter by list entry ID (requires list)
liststringNoList ID or slug to filter by (requires entryId)
limitnumberNoMaximum number of threads to return (max 50)
offsetnumberNoNumber of threads to skip for pagination

Output

ParameterTypeDescription
threadsarrayArray of threads
↳ threadIdstringThe thread ID
↳ commentsarrayComments in the thread
↳ commentIdstringThe comment ID
↳ contentPlaintextstringComment content
↳ authorobjectComment author
↳ typestringActor type
↳ idstringActor ID
↳ createdAtstringWhen the comment was created
↳ createdAtstringWhen the thread was created
countnumberNumber of threads returned

Attio Get Thread

Get a single comment thread by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesThe thread ID

Output

ParameterTypeDescription
threadIdstringThe thread ID
commentsarrayComments in the thread
↳ commentIdstringThe comment ID
↳ contentPlaintextstringComment content as plaintext
↳ authorobjectThe comment author
↳ typestringThe actor type (e.g. workspace-member, api-token, system)
↳ idstringThe actor ID
↳ createdAtstringWhen the comment was created
createdAtstringWhen the thread was created

Attio List Webhooks

List all webhooks in the Attio workspace

Inputs and outputs

Input

ParameterTypeRequiredDescription
limitnumberNoMaximum number of webhooks to return
offsetnumberNoNumber of webhooks to skip for pagination

Output

ParameterTypeDescription
webhooksarrayArray of webhooks
↳ webhookIdstringThe webhook ID
↳ targetUrlstringThe webhook target URL
↳ subscriptionsarrayEvent subscriptions
↳ eventTypestringThe event type (e.g. record.created)
↳ filterjsonOptional event filter
↳ statusstringWebhook status (active, degraded, inactive)
↳ createdAtstringWhen the webhook was created
countnumberNumber of webhooks returned

Attio Get Webhook

Get a single webhook by ID from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
webhookIdstringYesThe webhook ID

Output

ParameterTypeDescription
webhookIdstringThe webhook ID
targetUrlstringThe webhook target URL
subscriptionsarrayEvent subscriptions
↳ eventTypestringThe event type (e.g. record.created)
↳ filterjsonOptional event filter
statusstringWebhook status (active, degraded, inactive)
createdAtstringWhen the webhook was created

Attio Create Webhook

Create a webhook in Attio to receive event notifications

Inputs and outputs

Input

ParameterTypeRequiredDescription
targetUrlstringYesThe HTTPS URL to receive webhook events
subscriptionsstringYesJSON array of subscriptions (e.g. [{"event_type":"record.created","filter":{"object_id":"..."}}])

Output

ParameterTypeDescription
webhookIdstringThe webhook ID
targetUrlstringThe webhook target URL
subscriptionsarrayEvent subscriptions
↳ eventTypestringThe event type (e.g. record.created)
↳ filterjsonOptional event filter
statusstringWebhook status (active, degraded, inactive)
createdAtstringWhen the webhook was created
secretstringThe webhook signing secret (only returned on creation)

Attio Update Webhook

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
webhookIdstringYesThe webhook ID to update
targetUrlstringNoHTTPS target URL for webhook delivery
subscriptionsstringNoJSON array of subscriptions, e.g. [{"event_type":"note.created"}]

Output

ParameterTypeDescription
webhookIdstringThe webhook ID
targetUrlstringThe webhook target URL
subscriptionsarrayEvent subscriptions
↳ eventTypestringThe event type (e.g. record.created)
↳ filterjsonOptional event filter
statusstringWebhook status (active, degraded, inactive)
createdAtstringWhen the webhook was created

Attio Delete Webhook

Delete a webhook from Attio

Inputs and outputs

Input

ParameterTypeRequiredDescription
webhookIdstringYesThe webhook ID to delete

Output

ParameterTypeDescription
deletedbooleanWhether the webhook was deleted

Attio List Attributes

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
targetstringYesWhether the attributes belong to an object or a list: objects or lists
identifierstringYesThe object or list ID or slug (e.g. people, companies)
limitnumberNoMaximum number of attributes to return
offsetnumberNoNumber of attributes to skip for pagination
showArchivedbooleanNoWhether to include archived attributes (default false)

Output

ParameterTypeDescription
attributesarrayArray of attributes
↳ attributeIdstringThe attribute ID
↳ titlestringThe attribute display title
↳ apiSlugstringThe attribute API slug
↳ descriptionstringThe attribute description
↳ typestringThe attribute value type (e.g. text, number, select, record-reference)
↳ isSystemAttributebooleanWhether this is a built-in system attribute
↳ isWritablebooleanWhether the attribute can be written to
↳ isRequiredbooleanWhether new records must provide a value
↳ isUniquebooleanWhether the attribute enforces uniqueness
↳ isMultiselectbooleanWhether the attribute supports multiple values
↳ isDefaultValueEnabledbooleanWhether this attribute has a default value enabled
↳ isArchivedbooleanWhether the attribute is archived
↳ defaultValuejsonThe default value for this attribute, if enabled
↳ relationshipjsonThe related attribute, if this attribute is part of a relationship
↳ configjsonType-dependent attribute configuration
↳ createdAtstringWhen the attribute was created
countnumberNumber of attributes returned

Attio Get Attribute

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
targetstringYesWhether the attribute belongs to an object or a list: objects or lists
identifierstringYesThe object or list ID or slug (e.g. people, companies)
attributestringYesThe attribute ID or slug

Output

ParameterTypeDescription
attributeIdstringThe attribute ID
titlestringThe attribute display title
apiSlugstringThe attribute API slug
descriptionstringThe attribute description
typestringThe attribute value type (e.g. text, number, select, record-reference)
isSystemAttributebooleanWhether this is a built-in system attribute
isWritablebooleanWhether the attribute can be written to
isRequiredbooleanWhether new records must provide a value
isUniquebooleanWhether the attribute enforces uniqueness
isMultiselectbooleanWhether the attribute supports multiple values
isDefaultValueEnabledbooleanWhether this attribute has a default value enabled
isArchivedbooleanWhether the attribute is archived
defaultValuejsonThe default value for this attribute, if enabled
relationshipjsonThe related attribute, if this attribute is part of a relationship
configjsonType-dependent attribute configuration
createdAtstringWhen the attribute was created

Attio Create Attribute

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
targetstringYesWhether to create the attribute on an object or a list: objects or lists
identifierstringYesThe object or list ID or slug (e.g. people, companies)
titlestringYesThe attribute display title
apiSlugstringYesThe attribute API slug (unique, snake_case)
typestringYesThe attribute value type (e.g. text, number, checkbox, currency, date, timestamp, rating, status, select, record-reference, actor-reference, location, domain, email-address, phone-number)
descriptionstringNoA description of the attribute
isRequiredbooleanNoWhether new records must provide a value (default false)
isUniquebooleanNoWhether the attribute enforces uniqueness on new data (default false)
isMultiselectbooleanNoWhether the attribute supports multiple values (default false)
configstringNoJSON object of type-dependent configuration (e.g. currency or record-reference settings)

Output

ParameterTypeDescription
attributeIdstringThe attribute ID
titlestringThe attribute display title
apiSlugstringThe attribute API slug
descriptionstringThe attribute description
typestringThe attribute value type (e.g. text, number, select, record-reference)
isSystemAttributebooleanWhether this is a built-in system attribute
isWritablebooleanWhether the attribute can be written to
isRequiredbooleanWhether new records must provide a value
isUniquebooleanWhether the attribute enforces uniqueness
isMultiselectbooleanWhether the attribute supports multiple values
isDefaultValueEnabledbooleanWhether this attribute has a default value enabled
isArchivedbooleanWhether the attribute is archived
defaultValuejsonThe default value for this attribute, if enabled
relationshipjsonThe related attribute, if this attribute is part of a relationship
configjsonType-dependent attribute configuration
createdAtstringWhen the attribute was created

Attio Update Attribute

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
targetstringYesWhether the attribute belongs to an object or a list: objects or lists
identifierstringYesThe object or list ID or slug (e.g. people, companies)
attributestringYesThe attribute ID or slug to update
titlestringNoNew attribute display title
apiSlugstringNoNew attribute API slug
descriptionstringNoNew attribute description
isRequiredbooleanNoWhether new records must provide a value
isUniquebooleanNoWhether the attribute enforces uniqueness on new data
isArchivedbooleanNoArchive or unarchive the attribute
configstringNoJSON object of type-dependent configuration

Output

ParameterTypeDescription
attributeIdstringThe attribute ID
titlestringThe attribute display title
apiSlugstringThe attribute API slug
descriptionstringThe attribute description
typestringThe attribute value type (e.g. text, number, select, record-reference)
isSystemAttributebooleanWhether this is a built-in system attribute
isWritablebooleanWhether the attribute can be written to
isRequiredbooleanWhether new records must provide a value
isUniquebooleanWhether the attribute enforces uniqueness
isMultiselectbooleanWhether the attribute supports multiple values
isDefaultValueEnabledbooleanWhether this attribute has a default value enabled
isArchivedbooleanWhether the attribute is archived
defaultValuejsonThe default value for this attribute, if enabled
relationshipjsonThe related attribute, if this attribute is part of a relationship
configjsonType-dependent attribute configuration
createdAtstringWhen 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
threadIdstringThe thread ID
commentIdstringThe comment ID
objectIdstringThe object type ID
recordIdstringThe record ID
listIdstringThe list ID (if comment is on a list entry)
entryIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
threadIdstringThe thread ID
commentIdstringThe comment ID
objectIdstringThe object type ID
recordIdstringThe record ID
listIdstringThe list ID (if comment is on a list entry)
entryIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
threadIdstringThe thread ID
commentIdstringThe comment ID
objectIdstringThe object type ID
recordIdstringThe record ID
listIdstringThe list ID (if comment is on a list entry)
entryIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
threadIdstringThe thread ID
commentIdstringThe comment ID
objectIdstringThe object type ID
recordIdstringThe record ID
listIdstringThe list ID (if comment is on a list entry)
entryIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID

Attio List Deleted

Trigger workflow when a list is deleted in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID

Attio List Entry Created

Trigger workflow when a new list entry is created in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID
entryIdstringThe list entry ID

Attio List Entry Deleted

Trigger workflow when a list entry is deleted in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID
entryIdstringThe list entry ID

Attio List Entry Updated

Trigger workflow when a list entry is updated in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID
entryIdstringThe list entry ID
attributeIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
listIdstringThe list ID

Attio Note Created

Trigger workflow when a new note is created in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
noteIdstringThe note ID
parentObjectIdstringThe parent object type ID
parentRecordIdstringThe parent record ID

Attio Note Deleted

Trigger workflow when a note is deleted in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
noteIdstringThe note ID
parentObjectIdstringThe parent object type ID
parentRecordIdstringThe parent record ID

Attio Note Updated

Trigger workflow when a note is updated in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
noteIdstringThe note ID
parentObjectIdstringThe parent object type ID
parentRecordIdstringThe parent record ID

Attio Record Created

Trigger workflow when a new record is created in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
objectIdstringThe object type ID (e.g. people, companies)
recordIdstringThe record ID

Attio Record Deleted

Trigger workflow when a record is deleted in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
objectIdstringThe object type ID (e.g. people, companies)
recordIdstringThe record ID

Attio Record Merged

Trigger workflow when two records are merged in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
objectIdstringThe object type ID of the surviving record
recordIdstringThe surviving record ID after merge
duplicateObjectIdstringThe object type ID of the merged-away record
duplicateRecordIdstringThe record ID that was merged away

Attio Record Updated

Trigger workflow when a record is updated in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
objectIdstringThe object type ID (e.g. people, companies)
recordIdstringThe record ID
attributeIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
taskIdstringThe task ID

Attio Task Deleted

Trigger workflow when a task is deleted in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
taskIdstringThe task ID

Attio Task Updated

Trigger workflow when a task is updated in Attio

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
taskIdstringThe task ID

Attio Webhook (All Events)

Trigger workflow on any Attio webhook event

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
idjsonThe event ID object containing resource identifiers
parentObjectIdstringThe parent object type ID (if applicable)
parentRecordIdstringThe 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

ParameterTypeRequiredDescription
triggerCredentialsstringYesAttio Account

Output

ParameterTypeDescription
eventTypestringThe type of event (e.g. record.created, note.created)
workspaceIdstringThe workspace ID
workspaceMemberIdstringThe workspace member ID
Was this helpful?
Suggest an edit