Connect to Attio to manage CRM records (people, companies, custom objects), notes, tasks, lists, list entries, comments, workspace members, and webhooks.
Query and list records for a given object type (e.g. people, companies)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | 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 |
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single record by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | The object type slug (e.g. people, companies) |
recordId | string | Sí | The ID of the record to retrieve |
| Parámetro | Tipo | Descripción |
|---|
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 |
Create a new record in Attio for a given object type
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | The object type slug (e.g. people, companies) |
values | string | Sí | JSON object of attribute values to set on the record |
| Parámetro | Tipo | Descripción |
|---|
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 |
Update an existing record in Attio (appends multiselect values)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | The object type slug (e.g. people, companies) |
recordId | string | Sí | The ID of the record to update |
values | string | Sí | JSON object of attribute values to update |
| Parámetro | Tipo | Descripción |
|---|
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 |
Delete a record from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | The object type slug (e.g. people, companies) |
recordId | string | Sí | The ID of the record to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the record was deleted |
Fuzzy search for records across object types in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
query | string | Sí | The search query (max 256 characters) |
objects | string | Sí | Comma-separated object slugs to search (e.g. people,companies) |
limit | number | No | Maximum number of results (1-25, default 25) |
| Parámetro | Tipo | Descripción |
|---|
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 |
Upsert a record in Attio — creates it if no match is found, updates it if a match exists
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
objectType | string | Sí | The object type slug (e.g. people, companies) |
matchingAttribute | string | Sí | The attribute slug to match on for upsert (e.g. email_addresses for people, domains for companies) |
values | string | Sí | JSON object of attribute values (e.g. {"email_addresses":[{"email_address":"test@example.com"}]}) |
| Parámetro | Tipo | Descripción |
|---|
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 |
List notes in Attio, optionally filtered by parent record
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
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 |
| Parámetro | Tipo | Descripción |
|---|
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 (e.g. workspace-member) |
↳ workspaceMemberId | string | The workspace member ID of the tagger |
↳ 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 |
Get a single note by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
noteId | string | Sí | The ID of the note to retrieve |
| Parámetro | Tipo | Descripción |
|---|
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 (e.g. workspace-member) |
↳ workspaceMemberId | string | The workspace member ID of the tagger |
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 |
Create a note on a record in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
parentObject | string | Sí | The parent object type slug (e.g. people, companies) |
parentRecordId | string | Sí | The parent record ID to attach the note to |
title | string | Sí | The note title |
content | string | Sí | 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 |
| Parámetro | Tipo | Descripción |
|---|
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 (e.g. workspace-member) |
↳ workspaceMemberId | string | The workspace member ID of the tagger |
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 |
Delete a note from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
noteId | string | Sí | The ID of the note to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the note was deleted |
List tasks in Attio, optionally filtered by record, assignee, or completion status
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
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 or created_at:desc |
limit | number | No | Maximum number of tasks to return (default 500) |
offset | number | No | Number of tasks to skip for pagination |
| Parámetro | Tipo | Descripción |
|---|
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 |
↳ 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 |
Get a single task by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
taskId | string | Sí | The ID of the task to retrieve |
| Parámetro | Tipo | Descripción |
|---|
taskId | string | The task ID |
content | string | The task content |
deadlineAt | string | The task deadline |
isCompleted | boolean | Whether the task is 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 |
Create a task in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
content | string | Sí | 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":"..."}]) |
| Parámetro | Tipo | Descripción |
|---|
taskId | string | The task ID |
content | string | The task content |
deadlineAt | string | The task deadline |
isCompleted | boolean | Whether the task is 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 |
Update a task in Attio (deadline, completion status, linked records, assignees)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
taskId | string | Sí | 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 |
| Parámetro | Tipo | Descripción |
|---|
taskId | string | The task ID |
content | string | The task content |
deadlineAt | string | The task deadline |
isCompleted | boolean | Whether the task is 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 |
Delete a task from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
taskId | string | Sí | The ID of the task to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the task was deleted |
List all objects (system and custom) in the Attio workspace
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single object by ID or slug
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
object | string | Sí | The object ID or slug (e.g. people, companies) |
| Parámetro | Tipo | Descripción |
|---|
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 |
Create a custom object in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiSlug | string | Sí | The API slug for the object (e.g. projects) |
singularNoun | string | Sí | Singular display name (e.g. Project) |
pluralNoun | string | Sí | Plural display name (e.g. Projects) |
| Parámetro | Tipo | Descripción |
|---|
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 |
Update a custom object in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
object | string | Sí | 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 |
| Parámetro | Tipo | Descripción |
|---|
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 |
List all lists in the Attio workspace
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single list by ID or slug
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | The list ID or slug |
| Parámetro | Tipo | Descripción |
|---|
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 |
Create a new list in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
name | string | Sí | The list name |
apiSlug | string | No | The API slug for the list (auto-generated from name if omitted) |
parentObject | string | Sí | 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"}] |
| Parámetro | Tipo | Descripción |
|---|
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 |
Update a list in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | 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"}] |
| Parámetro | Tipo | Descripción |
|---|
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 |
Query entries in an Attio list with optional filter, sort, and pagination
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | 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 |
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single list entry by ID
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | The list ID or slug |
entryId | string | Sí | The entry ID |
| Parámetro | Tipo | Descripción |
|---|
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) |
Add a record to an Attio list as a new entry
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | The list ID or slug |
parentRecordId | string | Sí | The record ID to add to the list |
parentObject | string | Sí | The object type slug of the record (e.g. people, companies) |
entryValues | string | No | JSON object of entry attribute values |
| Parámetro | Tipo | Descripción |
|---|
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) |
Update entry attribute values on an Attio list entry (appends multiselect values)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | The list ID or slug |
entryId | string | Sí | The entry ID to update |
entryValues | string | Sí | JSON object of entry attribute values to update |
| Parámetro | Tipo | Descripción |
|---|
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) |
Remove an entry from an Attio list
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
list | string | Sí | The list ID or slug |
entryId | string | Sí | The entry ID to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the entry was deleted |
List all workspace members in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single workspace member by ID
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
memberId | string | Sí | The workspace member ID |
| Parámetro | Tipo | Descripción |
|---|
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 |
Create a comment on a list entry in Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
content | string | Sí | The comment content |
format | string | No | Content format: plaintext or markdown (default plaintext) |
authorType | string | Sí | Author type (e.g. workspace-member) |
authorId | string | Sí | Author workspace member ID |
list | string | Sí | The list ID or slug the entry belongs to |
entryId | string | Sí | The entry ID to comment on |
threadId | string | No | Thread ID to reply to (omit to start a new thread) |
createdAt | string | No | Backdate the comment (ISO 8601 format) |
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single comment by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
commentId | string | Sí | The comment ID |
| Parámetro | Tipo | Descripción |
|---|
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 |
Delete a comment in Attio (if head of thread, deletes entire thread)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
commentId | string | Sí | The comment ID to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the comment was deleted |
List comment threads in Attio, optionally filtered by record or list entry
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
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 |
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single comment thread by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
threadId | string | Sí | The thread ID |
| Parámetro | Tipo | Descripción |
|---|
threadId | string | The thread ID |
comments | array | Comments in the thread |
↳ type | string | The actor type (e.g. workspace-member, api-token, system) |
↳ id | string | The actor ID |
createdAt | string | When the thread was created |
List all webhooks in the Attio workspace
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
limit | number | No | Maximum number of webhooks to return |
offset | number | No | Number of webhooks to skip for pagination |
| Parámetro | Tipo | Descripción |
|---|
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 |
Get a single webhook by ID from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
webhookId | string | Sí | The webhook ID |
| Parámetro | Tipo | Descripción |
|---|
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 |
Create a webhook in Attio to receive event notifications
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
targetUrl | string | Sí | The HTTPS URL to receive webhook events |
subscriptions | string | Sí | JSON array of subscriptions (e.g. [{"event_type":"record.created","filter":{"object_id":"..."}}]) |
| Parámetro | Tipo | Descripción |
|---|
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) |
Update a webhook in Attio (target URL and/or subscriptions)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
webhookId | string | Sí | 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"}] |
| Parámetro | Tipo | Descripción |
|---|
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 |
Delete a webhook from Attio
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
webhookId | string | Sí | The webhook ID to delete |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Whether the webhook was deleted |