Attio tools
The 12 Attio operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- 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.
- List notesGETLists notes, of the whole workspace or of one record when parent_object and parent_record_id are set together. Each note has id.note_id, title and content in plain text and Markdown. Paginate with limit, 10 by default and up to 50, and offset.
- Create notePOSTCreates a note on a record. With format markdown, content takes headings, lists, bold, italic and links; with plaintext, a line break is a new line.
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.
