ArgorantDocs

Attio app

Install the Argorant app in Attio to find emails and people, fill empty fields, import saved lists and add people to campaigns, with your replies coming back to your records.

The Argorant app brings Argorant into your Attio workspace. On your people and company records you find work emails and people, fill empty fields and add people to campaigns. You bring a saved Argorant list into an Attio list, and replies to your campaigns come back as notes, tasks and workflow triggers.

The app never starts, schedules, pauses or sends a campaign and never touches your mailboxes. You start campaigns in Argorant. Anything that uses credits shows the cost first and runs only after you click.

Before you start

You need an Argorant account and an API key from it. Each person on your team connects with their own key, so credits and campaigns stay with their own Argorant account. Reply sync and the workflow trigger need the Argorant Pro plan or higher. If you do not have an account yet, start at argorant.com.

Install and connect

Install the app

Install the Argorant app from the Attio App Store and approve the access it asks for. The list of permissions and why the app needs each one is further down this page.

Create an API key

Sign in at app.argorant.com/profile, which opens your Argorant Settings. Open API keys, give the key a name and click Create key. The key is shown only once, so copy it right away.

Connect Argorant in Attio

In Attio, click your workspace name, open Workspace settings, then Installed apps, then Argorant. On the Connections tab, under Member connections, click Connect next to your name and paste the key.

Until you connect, every Argorant action in Attio tells you where to connect and does nothing else.

What you can do in Attio

The actions are on people and companies, in the bulk actions when you select people, and on the people page. The workflow trigger and steps are in the workflow builder.

WhereWhatCredits
A personFind email with ArgorantThe dialog shows the cost before the lookup
A personEnrich with ArgorantUp to 1 credit, a phone number has its own price
Selected peopleEnrich with ArgorantUp to 1 credit for each person Argorant finds
A companyFind people with ArgorantShowing people is free, up to 1 credit for each person you add
A companyEnrich with ArgorantIndustry and size are free, description and LinkedIn page up to 1 credit
The people pageImport an Argorant listFree for people you unlocked, up to 1 credit for each other person
A person or selected peopleAdd to an Argorant campaignFree
A personStop Argorant emailsFree
People and companiesThe Argorant widget and the Argorant tabFree
WorkflowsReply received in Argorant, Add person to an Argorant campaign, Remove person from an Argorant campaignFree

Find email with Argorant

On a person, choose Find email with Argorant. The first name, last name and company website come from the record, and you can change them in the dialog. The dialog shows what a found email costs, what a lookup without a result costs and how many credits you have. Click Find email. A found email is saved to the person. Sometimes the dialog offers an address for you to save with Save to this person instead of saving it right away.

If the person already has an email in Attio, the dialog says so, and a new lookup still uses credits. When the company website is missing, type it in the dialog or link the person to a company that has one in its Domains field.

Find people with Argorant

On a company, choose Find people with Argorant. Filter by job title, seniority, department and country, then click Show people to see up to 25 matching people for free. Tick the people you want and click Add to Attio. Before anything is charged, the app shows the cost, up to 1 credit for each person, and people you unlocked in Argorant before are free. The people are created in Attio, linked to the company. People already in Attio are left as they are. The company needs its website in the Domains field.

Enrich with Argorant

On a person, the dialog first shows which fields are empty and what a lookup costs. It uses up to 1 credit when Argorant finds the person. A person you unlocked before is free, and nothing is charged when no one is found. Click Look up. The app then offers values only for fields that are empty, such as job title, LinkedIn, seniority and email. Tick what to keep and click Save to Attio. When your plan includes phone numbers, a phone number is a separate tick with its price next to it, and it is charged only when a number is found.

Select many people to enrich them in one go. Tick job title, LinkedIn or seniority and confirm the cost of up to 1 credit for each person Argorant finds. People whose ticked fields are already filled are skipped and cost nothing. People you unlocked before are free. Argorant looks a person up by email, or by name and company website. A message shows the progress and what was filled at the end.

On a company, industry and company size are free and are matched to Attio's own options where those exist. The description and the LinkedIn page come from the full company profile, only when you tick them and after you confirm the cost of up to 1 credit.

Enrich never changes a field that already holds something.

Import an Argorant list

On the people page, choose Import an Argorant list. Under Argorant list pick one of your saved lists, under Attio list pick a list for people, and under Who to import choose People you unlocked, which is free, or Everyone on the list, which uses up to 1 credit for each person you have not unlocked and asks you to confirm the cost first. Click Import.

People already in Attio are matched by email and only put on the list. Nobody is added twice and no field is changed. Companies are matched by their website and created when Attio does not have them yet. People without an email are left out. At the end you see how many people were already in Attio, how many were created and what it cost.

Add people to a campaign

On a person, or on people you selected, choose Add to an Argorant campaign and pick a draft, running or paused campaign. Adding people is free. A draft or paused campaign sends nothing until you start it in Argorant. In a running campaign, the new people get its emails on its usual schedule. People without an email in Attio are left out, and people already in the campaign are not added again.

Stop Argorant emails

On a person, choose Stop Argorant emails. The dialog lists the draft, running and paused campaigns the person is in. Tick the ones to leave and click Stop emails. The person is taken out of those campaigns, also where a follow up is still due. The campaigns keep running for everyone else, and nothing is paused. This is free.

The Argorant widget and tab

The Argorant widget on a person shows the label of their latest reply with the campaign and date, or where they are in a campaign. The Argorant widget on a company shows how many people you can reach there, how many of them have a work email and how many replied. The Argorant tab on a company adds the people you can reach by seniority and by department, the latest replies from the company's people, and for each campaign how many of the company's people are in it, replied or are still getting emails.

Add the widget or the tab to the person or company page in Attio the same way as any other widget or tab. The counts are free.

Reply sync

Reply sync writes your Argorant replies into Attio. It is off until an admin turns it on, and it uses the Argorant account of the admin who turns it on.

To turn it on, an admin opens the same Argorant page (Workspace settings, then Installed apps, then Argorant) and clicks Turn on reply sync under Replies from Argorant. From then on, each reply to your Argorant campaigns adds a note to the person with the same email in Attio. The note holds the subject, the first lines of the reply, the campaign and the date. The person's Argorant reply field is set to the reply's label, and it follows when you change the label in Argorant. Nobody is created. A reply from an email that is not in Attio is skipped.

Under Tasks for interested replies, switch on Create a task for interested replies if you want tasks. A reply marked as interested then also creates one task for the person's owner. Under Give tasks to, pick the member who gets the task when the person has no owner.

To turn it off, click Turn off reply sync on the same page. Nothing more is written to Attio, and notes already written stay.

Turning reply sync on adds one webhook to the admin's Argorant account. If that account already has as many webhooks as it can have, delete one in Argorant and try again. If the admin who turned it on disconnects their key, replies stop coming in until the same admin connects again. Another admin can turn reply sync off and on again to use their own Argorant account.

Workflows

Reply received in Argorant starts a workflow. Under Start on, choose Every reply or Replies marked as interested. It passes the email, the label, the subject, the first lines of the reply, the campaign id and the time to the next steps. It needs the Argorant Pro plan or higher.

Add person to an Argorant campaign adds the person's email to a draft, running or paused campaign. It never starts a campaign. The next steps can follow its outcome, such as added, already in the campaign or no email in Attio.

Remove person from an Argorant campaign takes the person out of one campaign, or out of every campaign they are in when you choose Every campaign the person is in. Nothing is paused, and the campaigns keep running for everyone else.

Both steps are free. No workflow step uses credits.

Credits

Only Find email, Find people, Enrich and an import of everyone on a list can use credits. Each one shows the cost first and runs only after you click. Credits come from the Argorant account of the person who clicks, through their own key. Adding people to campaigns, stopping emails, the widget, the tab, reply sync and the workflow blocks are free.

Permissions the app asks for

PermissionWhy the app needs it
record_permission:read-writeRead people and companies to fill in lookups and campaign rows. Write a found email, values you chose to fill into empty fields, and the Argorant reply value. Create the people and companies you chose to add or import.
object_configuration:read-writeAdd the app's own fields when you first use them (Argorant reply, Seniority, and Industry or Company size when Attio has no matching option) and read the options of select fields so values match.
note:read-writeAdd a note for each reply when reply sync is on.
task:read-writeCreate a follow up task for interested replies when that switch is on.
user_management:readNeeded by Attio to create tasks and to pick who gets them.
list_configuration:readShow your lists for people when you import an Argorant list.
list_entry:read-writePut imported people on the list you chose.

The app never deletes or archives a record and never changes a field that already holds a value, except its own Argorant reply value.

Disconnect

To disconnect, open Workspace settings, then Installed apps, then Argorant. On the Connections tab, remove your connection under Member connections. After that the app no longer calls Argorant for you, and each action asks you to connect again. If you were the admin who turned on reply sync, replies stop coming in until you connect again. Removing the app from your workspace ends reply sync as well.

What the app already wrote to Attio stays there, such as notes, filled fields and the people it created. To stop the key itself from working, open your Argorant Settings at app.argorant.com/profile, then API keys, and click Revoke next to the key.

On this page