Attio
Keep Attio up to date with every customer, deal and order, without copy and paste.
42 ways to read, 27 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Attio, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create attribute
attributes.createApproval by rule - Create comment
comments.createApproval by rule - List activity types
activities.listRead
Example flow
- Attio · List activity types
activities.listDone - Attio · Create attribute
attributes.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Attio.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Attio
- Attio's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write Attio records, objects, attributes, lists, notes, tasks, comments and meetings with typed values, and read value history, emails, files and call recordings.
Attio API docs- Source actions
- 42
- Destination actions
- 27
- Data types
- 26
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
activities1
- List activity typesSource
System and custom activity types defined in the workspace (alpha API).
attributes4
- Create attributeDestinationProvider duplicate protectionApproval before production
Adds a custom attribute (field) to an object or list.
- Get attributeSource
One attribute definition with its Attio type and configuration.
- List attributesSource
Attribute definitions (custom fields) with their Attio types for an object or list.
- Update attributeDestinationProvider duplicate protectionApproval before production
Changes an attribute's title, description, slug, required or unique flags, or configuration. Archiving is not offered.
call recordings2
- Get call recordingSource
One call recording with its transcript when available.
- List call recordingsSource
Call recordings attached to a meeting.
comments3
- Create commentDestinationNot retried automaticallyApproval before production
Adds a comment to a record, a list entry, or an existing thread on behalf of a workspace member.
- Get commentSource
One comment by ID.
- List thread commentsSourceIncremental
Comments in one thread, oldest first, optionally only those created after a time.
companies3
- Get companySource
One companies record with all current attribute values.
- Query companiesSource
Query companies records with an optional Attio filter and sort.
- Assert companies recordDestinationProvider duplicate protectionApproval before production
Creates or updates a record matched on a unique attribute (domains by default). Multiselect values are replaced.
deals3
- Create dealDestinationNot retried automaticallyApproval before production
Creates a deal record; name, stage and owner are required by default deal configuration.
- Get dealSource
One deals record with all current attribute values.
- Query dealsSource
Query deals records with an optional Attio filter and sort.
emails1
- List email metadataSourceIncremental
Metadata of synced emails linked to records or a company domain; email content is never returned.
entries5
- Add record to listDestinationNot retried automaticallyApproval before production
Adds a record to a list as a new entry. Multiple entries per record are allowed.
- Get list entrySource
One list entry with its list-specific attribute values.
- Query list entriesSource
Entries in a list with their list-specific attribute values.
- Update list entryDestinationProvider duplicate protectionApproval before production
Updates list attribute values on an entry; multiselect values are appended.
- Upsert list entry by parent recordDestinationProvider duplicate protectionApproval before production
Creates the list entry for a record, or updates it when the record is already in the list.
files2
- Get fileSource
One file or folder entry (metadata only).
- List record filesSource
Files and folders attached to a record, including connected storage.
lists4
- Create listDestinationProvider duplicate protectionApproval before production
Creates a list for one parent object, shared with the whole workspace.
- Get listSource
One list by slug or ID.
- List listsSource
Lists the token can access.
- Update listDestinationProvider duplicate protectionApproval before production
Renames a list or changes its API slug. Access settings are not changed.
meetings4
- Create meetingDestinationNot retried automaticallyApproval before production
Creates a meeting from another calendar or dialer and links it to records. Attio always creates a new meeting.
- Get meetingSource
One meeting with participants and linked records.
- List meetingsSource
Meetings, optionally linked to one record.
- Link records to meetingDestinationProvider duplicate protectionApproval before production
Adds linked records to a meeting; already linked records are ignored and none are removed.
notes4
- Create noteDestinationNot retried automaticallyApproval before production
Adds a plain-text or Markdown note to a record.
- Get noteSource
One note with plain-text and Markdown content.
- List notesSource
Notes for all records, or for one record.
- Update noteDestinationProvider duplicate protectionApproval before production
Changes a note's title or replaces its content. The parent record cannot change.
objects4
- Create custom objectDestinationProvider duplicate protectionApproval before production
Creates a custom object. The API slug must be unique in the workspace.
- Get objectSource
One standard or custom object by slug or ID.
- List objectsSource
Standard and custom objects in the workspace.
- Update objectDestinationProvider duplicate protectionApproval before production
Renames an object or changes its API slug.
people3
- Get personSource
One people record with all current attribute values.
- Query peopleSource
Query people records with an optional Attio filter and sort.
- Assert people recordDestinationProvider duplicate protectionApproval before production
Creates or updates a record matched on a unique attribute (email_addresses by default). Multiselect values are replaced.
record entries1
- List record's list entriesSource
Every list entry whose parent is the record, across all lists.
record values1
- List record attribute valuesSource
Current or historic values of one attribute on a record, for example a deal's stage history.
records6
- Create recordDestinationNot retried automaticallyApproval before production
Creates a record of any object. Fails on conflicts with unique attributes.
- Get recordSource
One record with all current attribute values.
- Query recordsSource
Query records of any standard or custom object with an optional Attio filter and sort.
- Search recordsSource
Fuzzy search on names, domains, emails, phone numbers and social handles across objects.
- Update recordDestinationProvider duplicate protectionApproval before production
Updates attribute values on a record. Multiselect values are appended unless overwriteMultiselect is true.
- Assert recordDestinationProvider duplicate protectionApproval before production
Creates or updates a record matched on a unique attribute. Multiselect values are replaced.
select options3
- Create select optionDestinationNot retried automaticallyApproval before production
Adds an option to a select attribute.
- List select optionsSource
Options of a select attribute on an object or list.
- Rename select optionDestinationProvider duplicate protectionApproval before production
Renames a select option. Archiving is not offered.
self1
- Identify tokenSource
The workspace and scopes the access token is linked to.
sequence unsubscribes1
- Add email to sequence unsubscribe listDestinationProvider duplicate protectionApproval before production
Adds an email address to the workspace's sequence unsubscribe list so it cannot be enrolled, and exits its active sequence runs.
statuses3
- Create statusDestinationNot retried automaticallyApproval before production
Adds a status (stage) to a status attribute.
- List statusesSource
Statuses (pipeline stages) of a status attribute, for example deal stage.
- Update statusDestinationProvider duplicate protectionApproval before production
Renames a status or changes its celebration or target time. Archiving is not offered.
tasks4
- Create taskDestinationNot retried automaticallyApproval before production
Creates a plain-text task with optional deadline, linked records and assignees.
- Get taskSource
One task with linked records and assignees.
- List tasksSource
Tasks, optionally for one linked record, assignee or completion state.
- Update taskDestinationProvider duplicate protectionApproval before production
Updates a task deadline, completion, linked records or assignees.
threads1
- List comment threadsSource
Comment threads on a record or list entry, each with up to 80 comments.
views1
- List saved viewsSource
Saved views for an object or list; a view ID can be used as filterViewId in queries.
webhooks2
- Get webhookSource
One webhook endpoint with its subscriptions.
- List webhooksSource
Webhook endpoints and their event subscriptions.
workspace members2
- Get workspace memberSource
One workspace member by ID.
- List workspace membersSource
Workspace members, used as record owners and task assignees.
Access and limits
- Authentication
- Attio workspace access token
- Plans and access
- All Attio plans can create workspace access tokens. Each token carries scopes chosen in Workspace settings → Developers; records follow those scopes.
- Test environment
- A free Attio workspace can be used for testing.
- Rate limits
- 100 read and 25 write requests per second per workspace; HTTP 429 with Retry-After.
- Pagination
- limit/offset for record and entry queries, attribute values, notes, tasks, threads and webhooks; next_cursor for meetings, comments, emails, files, views, call recordings and activities.
- Provider events
- Attio webhooks for record, list entry, note, task and comment events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Record queries have no last-modified filter; filter on a timestamp attribute you maintain, or on created_at.
- Tasks are created from plain text only; Attio does not accept rich text or record mentions in task content.
- Assert (upsert) replaces multiselect values; record update appends multiselect values unless overwriteMultiselect is set.
- Record and entry creation have no idempotency key; uncertain creates are not repeated automatically.
- Meetings are always created new; Attio does not deduplicate them against calendar-synced meetings.
- Emails are listed as metadata only (no content), and only by linked record or domain so participant addresses stay out of URLs.
- Files are read as metadata; uploads (multipart) and downloads (signed redirects) are not offered by the recipe engine.
- Deletes, record merges, attribute-value history overwrites, archiving and list access changes are intentionally not offered.
- The Enterprise SQL endpoint is not offered; use records.list with Attio filters instead.
Developer reference
- Create the Attio credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Attio, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/attio and the Connections API.
