Clean for Attio
Keep your Attio workspace in step with the prospects, companies, lists and columns you keep in Clean, and bring your team's edits back.
Clean AI Labs, Inc. · Last updated Oct 28, 2026
- Direction
- Both ways: Clean writes to Attio, and edits to synced people come back
- Writes
- People, companies, lists and custom columns
- Reads
- People, to avoid duplicates and bring back edits
- Deletes
- Nothing in Attio
- Timing
- Writes on every change; reads about every 5 minutes
- Set up in
- Clean, Settings > Integrations
Overview
Clean is a research agent for B2B prospecting. It finds companies from what they actually do, such as loans, permits and customs shipments in public records, ranks them against your ideal customer profile, and finds the people to contact through licensed data providers. You choose which prospects to keep with Add to CRM.
The Attio app keeps your Attio workspace and Clean's CRM in step. Once connected, every prospect, company, list and custom column you keep in Clean appears in Attio automatically, with no exports, CSVs or re-typing, so your team can work the prospects where they already work. Edits your team makes in Attio to those people come back into Clean, and Clean checks who is already in Attio so it never adds them twice.
How it works
The sync runs both ways. Clean writes the prospects you keep to Attio, and reads the people in your Attio workspace for two reasons: to recognise people who are already there, so it updates them instead of creating duplicates, and to bring back edits your team makes to the people Clean synced. People who exist only in Attio stay out of your prospect list; Clean adds one only when a member asks for them in chat and confirms.
What Clean writes to Attio
- People
- Name, email, job title, LinkedIn URL, phone and their company.
- Companies
- Name, domain and LinkedIn URL.
- Lists
- Each Clean list becomes an Attio people list, with its members as list entries.
- Custom columns
- Each Clean column becomes an attribute on People (text, number, checkbox, date or select), with each person's value.
- Clean ID
- A clean_entity_id attribute on each person and company, so Clean finds the records it wrote and never creates them twice.
What Clean reads from Attio
- Who is in Attio
- Each person's name, email, phone, job title, LinkedIn URL, and who created the record and when. Clean keeps this as a private index to recognise people already in Attio and to count them on the connection card. People who are only in Attio stay out of your prospect list until a member adds them from chat.
- Edits to synced people
- A change to the name, email, job title, phone or LinkedIn URL of a person Clean synced is copied onto the prospect in Clean. Where Clean has no value for one of these fields, Attio's value fills it.
- People you ask about in chat
- A member of your Clean workspace can ask Clean's chat about people in that index, for example who at a company is already in Attio. Chat answers from the index and never changes Attio. To bring someone into Clean, chat shows a card listing exactly who it would add, at most 25 people, and Clean adds them as prospects linked to their Attio records only when the member who asked confirms. Nothing is sent to them.
- Not read
- Deals, notes, tasks, emails, meetings and custom objects. Changes to companies, lists and custom column values made in Attio stay in Attio.
What Clean reads from Attio stays inside your Clean workspace and is never used for any other workspace. You can turn reading off at any time (see Configuration).
When it syncs
When you connect
Clean backfills everything already in your Clean CRM, then reads the people already in Attio.
As you work
Each Add to CRM, edit, list change or new column is pushed to Attio within moments.
About every 5 minutes
Clean reads the people in Attio, brings back edits to the people it synced and refreshes its index of who is already there.
About every 30 minutes
A background check catches anything else that changed in Clean, for example a refreshed phone number.
Whenever you want
Press Sync now in Clean to run a full pass.
Matching and safety
- Before creating a record, Clean looks for it in Attio: people by email and companies by domain, then by the Clean ID it stamped, then by an exact LinkedIn URL. A match is updated instead of duplicated.
- Clean never matches people or companies by name alone.
- Clean never deletes people, companies or lists in Attio.
- Removing a prospect from a Clean list removes only that list entry in Attio.
- An archived Clean column is archived in Attio, which you can undo.
- Clearing a value in Clean clears only the value Clean wrote. Email addresses and phone numbers your team added in Attio stay.
- If the same field changes in both places between checks, the later edit wins.
- If a person Clean synced is deleted in Attio, Clean stops syncing them and keeps the prospect in Clean.
- Clean paces its reads and writes well under Attio's rate limits.
- Deals, notes, tasks and custom objects in Attio are outside the sync.
Configuration
- 1
Open Integrations in Clean
In Clean, open Settings > Integrations and find Attio in the CRM section. You need to be a member of the Clean workspace; viewers can see the page but cannot connect. One connection serves the whole workspace.
- 2
Connect and approve access in Attio
Click Connect, choose your Attio workspace and approve access. Clean asks for read-write access to records, object configuration, lists and list entries. It needs these to create the People attributes and lists that mirror your Clean CRM, and to read the people already in Attio (see Permissions).
- 3
Let the first sync run
The first sync starts right away, and the settings page shows its progress (“Initial sync in progress: N people so far”). Large CRMs can take a few minutes.
- 4
Choose whether Attio edits come back
“Bring Attio edits into Clean” on the connection card is on by default. Turn it off and Clean stops reading Attio, and keeps writing to it.
- 5
Work your prospects in Attio
From then on everything stays in sync on its own. Use Sync now to force a full pass.
Permissions
Attio shows these scopes when you approve the app. Clean asks for read-write access to each, and uses it only to keep Attio and Clean in step as this page describes.
- Records
- Read People to recognise who is already in Attio and to bring back edits to the people Clean synced. Create and update People and Company records, matched as described under How it works.
- Object configuration
- Find or create the People attributes that mirror your Clean columns, and the Clean ID attribute on People and Companies. Archive a column's attribute when you archive the column.
- Lists
- Find or create an Attio people list for each Clean list, so a list is never made twice.
- List entries
- Add each list member as an entry, and remove an entry when the prospect leaves the Clean list.
Clean does not use webhooks. It finds changes in Attio by reading on the schedule above, so it asks for no webhook access.
Disconnecting
To stop syncing, click Disconnect in Clean under Settings > Integrations. Clean revokes its Attio access, stops reading and writing, and deletes its index of the people in your Attio workspace.
- Everything Clean already wrote stays in your Attio workspace.
- Edits already brought back stay on the prospect in Clean.
- Clean keeps the Attio record IDs of the prospects it synced, so reconnecting the same Attio workspace updates those records instead of duplicating them.
You can also remove the app in Attio. Clean loses access at once and the sync stops; disconnect in Clean as well to delete the index.
Support
Questions about the Attio app? Email hello@tryclean.ai and we'll reply, typically within one to two business days.
What Clean sends to and reads from Attio, and what happens to it when you disconnect, is set out in the Privacy Policy and the Terms of Service. For the product view of this integration, see Clean and Attio.
Clean