CRM and sales
Attio in your product and your AI agents, through one API
The Attio toolkit covers objects and attributes, records, lists and their entries, and notes. Through Connect your product or AI agent calls them with one endpoint, while Connect stores and renews the credentials and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/attio_list_records/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"object": "<object>"
}
}How it works
From a connected customer to the first Attio call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Attio account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Attio.
Sync leads into Attio
A SaaS creates or updates a person or company record in its customer's Attio as soon as a signup happens.
Move deals between stages
A sales tool updates the entry of a pipeline list to move a deal to another stage.
Agent that logs notes
An AI agent reads records and writes call summaries as notes on the right record.
Tools
12 Attio tools
- List objectsGETLists the objects of the workspace: the standard ones, such as people, companies and deals, and the custom ones. Use the api_slug of an item as object in the record tools and as parent_object in the entry and note tools.
- List attributesGETLists the attributes of an object or of a list, in the order of the app, with the api_slug, the type and whether each one is required or unique. The slugs are the keys of values and entry_values in the other tools and of their filters.
- List recordsPOSTLists the records of an object, with an optional filter and sorts. Each record comes with id.record_id and its values keyed by attribute slug. Paginate with limit, 500 by default, and offset.
- Get recordGETReturns one record with all its values keyed by attribute slug and its web_url.
- Create recordPOSTCreates a record of an object, such as a person, a company or a deal. Fails when a unique attribute, such as a company domain or a person email, already belongs to another record. Returns the new record with id.record_id.
- Update recordPATCHUpdates the given attributes of a record and leaves the others unchanged. Values of a multiselect attribute are added to the ones it already has.
- List listsGETLists the lists of the workspace, such as sales pipelines, in the order of the sidebar. Use the api_slug of an item as list in the entry tools; its parent_object says which object its records come from.
- List entriesPOSTLists the entries of a list, with an optional filter and sorts on the list attributes, such as the stage of a pipeline. Each entry has id.entry_id, parent_record_id and parent_object. Paginate with limit, 500 by default, and offset.
- Create list entryPOSTAdds a record to a list as a new entry, with values for the list attributes, such as the stage. The same record can be added more than once. Returns the entry with id.entry_id.
- Update list entryPATCHUpdates the list attributes of an entry, such as moving a deal to another stage of a pipeline, and leaves the others unchanged. Values of a multiselect attribute are added to the ones it already has.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/attio, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
Questions about the Attio toolkit
Do I need to build against the Attio API?
No. Connect ships 12 Attio tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Attio account?
With the mode the toolkit accepts: API key, OAuth with your product's app. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
