Skip to content

Add attio docs#737

Open
emmithood wants to merge 4 commits intomainfrom
add-attio-docs
Open

Add attio docs#737
emmithood wants to merge 4 commits intomainfrom
add-attio-docs

Conversation

@emmithood
Copy link

Summary

  • Add Attio auth provider page with full OAuth setup instructions
  • Add Attio MCP Server integration page with all 20 tools documented
  • Add Attio to auth providers listing page with ToolCard
  • Add authProviderName prop linking ToolInfo card to auth provider docs
  • Add missing Attio.CreateReport tool with full parameter documentation

Known follow-ups

  • Logo in ToolInfo card: The Attio icon, icon map, and toolkit catalogue entry already exist in the monorepo
    (libs/design-system) but haven't been published to npm yet. Once a new design-system version is cut, the logo will render automatically
  • PyPI badges: arcade_attio isn't published on PyPI yet. Add <Badges repo="arcadeai/arcade_attio" /> once it is.
  • OAuth pending approval callout: Remove the warning callout on the auth provider page once Attio approves the Arcade OAuth app.

- Add auth provider page with OAuth setup guide, pending approval warning, and code examples
- Add MCP Server integration page documenting all 19 Attio tools
- Add Attio icon mark SVG
- Add Attio to auth providers catalog and sales navigation
- Add authProviderName="Attio" to ToolInfo for auth provider link
- Add missing Attio.CreateReport tool to table of contents and docs
- New "Reporting tools" section with full parameter documentation

Note: Attio logo in ToolInfo card requires a new design-system release.
The icon, icon map, and toolkit catalogue entry already exist in the
monorepo (libs/design-system) but haven't been published to npm yet.
Once a new version is cut, the logo will render automatically.
@emmithood emmithood requested review from byrro and jottakka February 9, 2026 07:28
@vercel
Copy link

vercel bot commented Feb 9, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Building Building Preview, Comment Feb 9, 2026 10:21pm
docs-1770675702675-X0RD Canceled Canceled Feb 9, 2026 10:21pm

Request Review

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Style Review

Found 18 style suggestion(s).

Powered by Vale + Claude

<Callout>
Want to quickly get started with Attio in your agent or AI app? The
[Arcade Attio MCP Server](/resources/integrations/sales/attio) is an [Arcade Optimized](/guides/create-tools/improve/types-of-tools#optimized-tools)
toolkit — hand-crafted and optimized for LLM usage.
Copy link
Contributor

@github-actions github-actions bot Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.EmDash: Removed spaces around the em dash

Suggested change
toolkit hand-crafted and optimized for LLM usage.
toolkit: hand-crafted and optimized for LLM usage.


This page describes how to use and configure Attio auth with Arcade.

This auth provider is used by:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Passive: Changed from passive to active voice

Suggested change
This auth provider is used by:
Use this auth provider with:


In a production environment, you will most likely want to use your own Attio app credentials. This way, your users will see your application's name requesting permission.

Before showing how to configure your Attio app credentials, let's go through the steps to create an Attio integration.
Copy link
Contributor

@github-actions github-actions bot Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.We: Remove first-person plural 'let's':

Suggested change
Before showing how to configure your Attio app credentials, let's go through the steps to create an Attio integration.
Before showing how to configure your Attio app credentials, you'll create an Attio integration.

- Enter `attio` as the **ID** for your provider.
- Optionally enter a **Description**.
- Enter the **Client ID** and **Client Secret** from your Attio integration.
- Note the **Redirect URL** generated by Arcade. This must be added as a redirect URI in your Attio integration's OAuth settings.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Passive: Changed from passive to active voice

Suggested change
- Note the **Redirect URL** generated by Arcade. This must be added as a redirect URI in your Attio integration's OAuth settings.
- Note the **Redirect URL** generated by Arcade. You must add this as a redirect URI in your Attio integration's OAuth settings.


#### Create the provider

Hit the **Create** button and the provider will be ready to be used.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Passive: Changed from passive to active voice

Suggested change
Hit the **Create** button and the provider will be ready to be used.
Hit the **Create** button and the provider will be ready to use.

**Parameters**

- **object_type** (`string`, required) Object slug (e.g., `people`, `companies`, `deals`)
- **matching_attribute** (`string`, required) Unique attribute for upsert match (e.g., `email_addresses`, `domains`)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Latin: Replace 'e.g.' with 'for example'

Suggested change
- **matching_attribute** (`string`, required) Unique attribute for upsert match (e.g., `email_addresses`, `domains`)
- **matching_attribute** (`string`, required) Unique attribute for upsert match (for example, `email_addresses`, `domains`)


Update a record directly by ID.

Unlike `AssertRecord`, this doesn't require a unique matching attribute. For status fields like `stage`, pass the status title as a string (e.g., `{"stage": "Closed Won"}`).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Latin: Replace 'e.g.' with 'for example'

Suggested change
Unlike `AssertRecord`, this doesn't require a unique matching attribute. For status fields like `stage`, pass the status title as a string (e.g., `{"stage": "Closed Won"}`).
Unlike `AssertRecord`, this doesn't require a unique matching attribute. For status fields like `stage`, pass the status title as a string (for example, `{"stage": "Closed Won"}`).


**Parameters**

- **object_type** (`string`, required) Object slug (e.g., `people`, `companies`, `deals`)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Latin: Replace 'e.g.' with 'for example'

Suggested change
- **object_type** (`string`, required) Object slug (e.g., `people`, `companies`, `deals`)
- **object_type** (`string`, required) Object slug (for example, `people`, `companies`, `deals`)


Generate a report from Attio records for export to Google Sheets.

Returns data formatted for easy insertion into a spreadsheet: headers (column names), rows (values aligned with headers), and a dict format for the Google Sheets API. Use this output with Google Sheets tools to create a spreadsheet.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alex.Condescending: Remove 'easy' to avoid condescending language

Suggested change
Returns data formatted for easy insertion into a spreadsheet: headers (column names), rows (values aligned with headers), and a dict format for the Google Sheets API. Use this output with Google Sheets tools to create a spreadsheet.
Returns data formatted for insertion into a spreadsheet: headers (column names), rows (values aligned with headers), and a dict format for the Google Sheets API. Use this output with Google Sheets tools to create a spreadsheet.


**Parameters**

- **object_type** (`string`, required) Object slug (e.g., `people`, `companies`, `deals`, or custom)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google.Latin: Replace 'e.g.' with 'for example'

Suggested change
- **object_type** (`string`, required) Object slug (e.g., `people`, `companies`, `deals`, or custom)
- **object_type** (`string`, required) Object slug (for example, `people`, `companies`, `deals`, or custom)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant