ConnectorsAttio

Connect Attio

Connect Attio with an access token, see what Gurusup reads from your records, lists and meetings, bring in older records, and fix a token Attio rejects.

Admins only. Gurusup reads your companies, deals and custom objects, the lists and stages they sit in, and the notes, tasks, comments and meetings around them. You can ask "What is blocking the renewal with this company?" and get the Attio deal joined with the Slack thread and the last meeting about it. Gurusup only reads Attio; it creates just its own webhook there.

At a glance

TopicDetails
Who can connectAdmins
What you needAn Attio access token with the scopes below, created by an Attio workspace admin
What Gurusup readsEvery object your Attio workspace has turned on, or only the ones you choose, with people, lists, notes, tasks, comments and meetings
How changes arriveWithin minutes through a webhook
Past contentImport history, from last week to last year
Knowledge accessDefault access, Restricted or Private. See Who can read it.

Before you start

  • You are an admin in Gurusup.
  • A workspace admin in Attio creates an access token for Gurusup under Workspace settings > Developers > Access tokens. The steps suggest naming it “Gurusup” so you recognise it later.
  • One Gurusup organization takes one Attio connection.

The scopes the token needs

When you connect for the first time, Gurusup checks every one of these before it lets you connect.

ScopeLevel
RecordsRead
Object configurationRead
NotesRead
TasksRead
CommentsRead
MeetingsRead
Call recordingsRead
User managementRead
List entriesRead
List configurationRead
WebhooksRead-write

A read-write scope also counts where Gurusup only needs read. Webhooks is read-write so Gurusup can create and delete its own webhook; it never deletes other webhooks.

List entries and List configuration let Gurusup read which lists, stages and owners each record has. They are required for a new connection and optional when you reconnect. See Connections made before lists.

Connect Attio

Open the Attio connector

In the sidebar, open Sources, then Catalog, find Attio (use Search sources if you need to) and click Connect on its row. Its page opens. Next to Organization accounts, click Connect for the organization. The dialog Connect Attio for the organization opens.

Create the token

Under the Access token field, the hint says an Attio workspace admin creates it in Workspace settings → Developers → Access tokens, and Show steps lists the scopes above. Create the token in Attio and copy it.

Paste the token

Paste it in Access token. Gurusup says "Reading what this token reaches in Attio…" and then shows your Attio workspace with Companies and Deals created in the last 90 days, for example "120 companies in the last 90 days" ("500+" past 500). Without deals in your Attio workspace, the row reads "Deals aren't turned on in this workspace".

Check the scopes

A mark next to each scope shows which ones the token has. If one is missing, the dialog says which and Connect stays off. For example, "This Attio token needs Read for List entries, List configuration. Ask a workspace admin to edit its Scopes in Workspace settings → Developers → Access tokens, then paste the token again." See If it does not work.

Choose what Gurusup learns

When the check ends, "What should Gurusup learn from Attio?" appears. Leave the defaults or change them, as described in Choose what Gurusup learns. Connect stays off until its rows load and while a Custom row has no value. It does not wait for the counts: they load in the background, and if they never arrive you can still connect.

Choose who can read it

Under Who can read it, Access mode starts as Default access. Choose Restricted or Private to limit the source to the people you pick.

Connect

Click Connect. A message says "Attio connected." and the connection appears under Organization accounts with a Connected badge.

What Gurusup reads

Gurusup makes one document per record of each object your Attio workspace has turned on: companies, deals, custom objects such as "Investors" or "Projects", and the optional users and workspaces objects. Each document carries a link to open the record in Attio and uses the names your Attio workspace gives its objects.

PartWhat Gurusup reads
DetailsThe record's attributes, such as name, domains, owner, stage, value and dates. Identifiers, logos, avatars, most social profile links and archived attributes are left out.
PeopleFor a company, its team. For a deal, its associated people. Name, job title and email.
RelatedThe company of a deal, and the deals of a company, by name.
ListsEach list the record is in, with its stage, owner, the list's own columns and the comments on its entry. The lists of a person show on their company. Needs the List entries and List configuration scopes.
NotesNewest first. A company also gets the notes on its people, marked with the person's name. A note longer than 20,000 characters is cut, with a link to the full version in Attio.
TasksLinked tasks, with whether they are done, the due date and who they are assigned to. Attio links tasks only to companies and people.
CommentsComment threads with author, date and whether they are resolved.
MeetingsEvery meeting linked to the record, recorded or not, with its title, date, participants and description. When Attio finished processing a recording, the transcript comes with it. A transcript longer than 120,000 characters is cut, with a link to the full version in Attio.

People have no document of their own. They come in through their company's or deal's document. By default, a person who belongs to no company or deal that Gurusup reads is not read, and what Gurusup already learned about them stays. An admin can change that with the People row: see Choose what Gurusup learns.

How big a document can get

A document has a size limit. Details, people and lists always go in. Notes, tasks, comment threads and meetings share what is left, newest first, and each section keeps at least its newest item. Whatever does not fit is counted at the end of its section, for example "3 more notes not included here. See them in Attio:" followed by a link. The same line exists for tasks, comment threads and meetings.

What Gurusup does not read

Left outDetail
Your own companyGurusup takes your team's email domains from your Attio workspace members (public providers such as gmail.com excluded). A company with one of them never gets a document, so internal calls do not pile up on it. If Gurusup already had a document for it, it is withdrawn.
Objects your Attio workspace has not turned onFor deals, the preview says "Deals aren't turned on in this workspace".
People outside a company or deal Gurusup readsBy default. You can change it with the People row. See Choose what Gurusup learns.
Recordings still processingGurusup looks again for two hours after the meeting ends. A recording that finishes later comes in the next time the record is read. Recordings Attio failed to process never come in.

Choose what Gurusup learns

An admin chooses which Attio records Gurusup learns from, on screen. When you connect, "What should Gurusup learn from Attio?" appears after the token check. Reconnecting with a new token does not show it and keeps your saved choice. Later, open the Attio page from Sources and find the choices under Content. The lists you saved show at once, without waiting for Attio, and the rest loads after. Only admins see it, while the connection is connected, active or degraded. If the connection needs a new token, the choices stay hidden until you reconnect.

Each object your Attio workspace lists, custom objects included, gets its own block of two lines. The first line has the object name, its count and the Bring in switch. The second has All and Custom, then the values you chose. Companies, Deals and People come first, and Deals only shows when your Attio workspace has them.

In a rowWhat it does
Bring in switch ("Bring in" followed by the object name)Off, the row reads "Not brought in".
AllReads "Every company", "Every deal" or "Every person". Includes future records.
CustomOnly records with any of the values you add. Each value is a button with an X: click it to remove the value. Without a value the row reads "Add at least one value".
AddOpens a search ("Search values…") across attributes, Saved views and Lists, each with its count, named like "In view: …" or "In list: …". People also offers "Linked to the companies and deals above". Choosing by list needs the List entries and List configuration scopes.
Count"84 of 1,930", or "0 of 1,930" when off. It stops at 10,000 and reads "10,000+", a minimum. Under the rows, "84 companies · 1 deal today." sums them up, and "Updating counts…" shows while it recalculates. Counting runs in the background and never holds up the screen or a save. If it takes too long you read "Counting is taking too long right now, usually because the workspace is large. Your choices still apply, and you can connect." while connecting, and the same without ", and you can connect" on the Attio page. These are matching records, not documents counted toward your usage.

Defaults. Companies and Deals are All. People is Custom with "Linked to the companies and deals above", also on connections with no saved choice, so a person with no company or deal does not update even with notes or calls. Set People to All to change that. It restores the earlier rule: a loose person still needs notes or calls. A choice saved earlier through an assistant is kept.

Saving. On a connected source there is no Save or Cancel. Each change saves by itself after a moment, and "Saved." appears under the list with "Starts updating: …" and "Stops updating: …. What stops stays in memory." While a Custom row has no value, Gurusup only recounts and saves nothing until you add the first value. If a change cannot be saved, you read "Gurusup couldn't save these Attio choices. Your previous choices still apply. Contact support if it keeps happening." In the connect step nothing is saved until you click Connect.

A choice never imports history. New records, and records that start matching, come in from then on. Use Import history for older activity. An assistant can make the same choices; see Tools reference.

How changes arrive

Attio tells Gurusup about changes through Gurusup's webhook, so new activity arrives within minutes, and Gurusup rebuilds the company or deal document it touches, unless Attio only recalculated a value by itself. A deleted or merged record is withdrawn: what Gurusup learned only from it leaves, and anything other sources also back stays.

If Gurusup can no longer open a record, for example because the token lost access, it keeps what it had.

Gurusup starts from the moment you connect: connecting does not bring in earlier activity or upcoming meetings, and an older record does not come in on its own. Older activity comes in with Import history. When a record gets new real activity after you connect, such as a note, task, comment, edit or a meeting that has ended, Gurusup brings in the whole record with its earlier content too. A meeting comes in when it ends, and only if it ends after you connect: Gurusup checks for ended meetings every 5 minutes, and a meeting that has not ended yet is left out until it does. Meetings that ended before you connected come in only through Import history.

Import past work

Until you import, History reads "Only new content comes in until you import past content."

Open Import history

On Sources, open the Attio page. Under History, click Import history.

Pick how far back

Pick Last week, Last month, Last 3 months, Last 6 months or Last year. The dialog counts the records created in that window for each object, for example "~120 companies, ~30 deals" ("500+" past 500), plus older records that have a meeting or task from the window. It does not count notes, so a record that only has notes can add to the count. It shows what the import would use out of what you have left this month, in euros. Records with notes, tasks or meetings from that window come in too.

Import

Click Import. The message reads "Importing history. It keeps going in the background." When it is done, the row reads "Imported the last" followed by the window and the date.

You can import a longer window later. See How connectors keep Gurusup in sync.

Who can read it

The Attio connection is one source.

Knowledge accessWho reads it in Brain
Default accessEveryone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them.
RestrictedOnly the people you pick. Administrators are not included unless you pick them.
PrivateOnly you. Administrators are not included.

A choice made when you connect applies before Gurusup reads anything. To change it later, open the Attio page and change Access mode under Knowledge access; it saves as soon as you change it and applies only to what Gurusup learns after that. See Restrict a source to specific people.

Check that it worked

  1. On Sources, an Attio row is there.
  2. Open the Attio page. Under Content, Gurusup lists each object your Attio workspace has, such as Companies, Deals, People and your custom objects, with the choices you saved.
  3. Add a note to a company in Attio. Open Ingest and pick the Attio source in the source filter. The company moves to Learned. See Follow ingestion.

Reconnect

To swap the token, open the Attio page from Sources and click Reconnect on the account's row. Paste a token from the same Attio workspace in Access token, wait for the preview and click Reconnect. Gurusup keeps the source, its access and what it learned.

When Attio stops accepting the token, for example because it was deleted or lost a scope, the badge reads Needs reconnect. Click Reconnect on the account's row. Until you reconnect, Gurusup reads nothing new from Attio. Create a new token with the scopes above and paste it.

Connections made before lists

A connection made before List entries and List configuration existed keeps working without reconnecting. It reads everything else, including custom objects and meetings, but not the lists, stages and owners of each record. The Reconnect dialog names the missing scopes. When you reconnect, the two list scopes are optional: Gurusup says "List entries and List configuration are optional here: they add which lists, stages and owners each record has." Without them it adds "Without List entries and List configuration, Gurusup reads everything else but not which lists, stages and owners each record has." Gurusup updates its webhook in Attio by itself to receive list changes, at the next health check or when you reconnect.

Disconnect

On Sources, open the Attio page. Under Danger zone, open the menu on Disconnect, choose Disconnect and confirm. Gurusup deletes its webhook in Attio and forgets the token, which stays in Attio under Workspace settings > Developers > Access tokens until you delete it; see Remove, disconnect and what stays.

If it does not work

MessageWhat to do
"This Attio token needs Read for Notes; Read-write for Webhooks. Ask a workspace admin to edit its Scopes in Workspace settings → Developers → Access tokens, then paste the token again." (it names only what is missing)In Attio, give the token the missing scopes and paste it again.
"This Attio token needs Read for List entries, List configuration. Ask a workspace admin to edit its Scopes in Workspace settings → Developers → Access tokens, then paste the token again." (new connection only)In Attio, give the token the two list scopes and paste it again.
"Attio no longer accepts this access token. Ask a workspace admin to create a new one in Workspace settings → Developers → Access tokens, then paste it here."The token is mistyped, revoked or inactive. Create a new one and paste it.
"This token belongs to a different Attio workspace. Use a token from the workspace you're reconnecting, from Workspace settings → Developers → Access tokens."Use a token from the Attio workspace already connected.
"Only organization admins can manage integrations."Ask an admin in Gurusup to connect Attio.
"Attio needs to be reconnected with a new access token."Click Reconnect on the account's row and paste a new token. See Reconnect.
"Reconnect Attio to choose what it shares." in What Gurusup learnsClick Reconnect and paste a token from the same Attio workspace.
"We couldn't manage your source choices because of a problem on our side. Your existing knowledge is safe. We've logged the problem. Contact support for help."Your knowledge is safe. Contact support.
"Gurusup couldn't save these Attio choices. Your previous choices still apply. Contact support if it keeps happening."Your previous choices stay. Contact support if it keeps happening.
"Gurusup couldn't read your Attio workspace. Contact support if it keeps happening." in What Gurusup learnsContact support.
"Attio needs a new access token. Reconnect Attio." in the Import history dialogReconnect, then import again.
"The import didn't finish. Try again, and contact support if it keeps failing."Click Try again. If it keeps failing, contact support.
"We couldn't read your Attio workspace because of a problem on our side. Nothing was connected. Contact support for help."Contact support.
"We couldn't connect Attio because of a problem on our side. Nothing was connected. Try again in a few minutes, and contact support if it keeps failing."Wait a few minutes and try again. If it keeps failing, contact support. Only Attio refusing the token asks you to replace it: a problem setting up Gurusup's webhook shows this message instead.
"We couldn't read your Attio workspace because of a problem on our side. Your connection is saved. Contact support for help."The connection still works. Contact support if it keeps showing.
"Gurusup couldn't read this Attio token. Contact support for help."Contact support.
"Ingestion is paused for this organization. Ask your organization admin to resume ingestion before adding content." or "Demo Mode prevents changing external sources. Ask your organization admin to turn off Demo Mode to continue."Connecting, reconnecting and changing what a source brings in are off. Disconnect still works while ingestion is paused, but not in Demo Mode. See Connectors overview.

Nothing coming in and no message? See Connector troubleshooting.