diff --git a/docs-v2/integrations/all/attio.mdx b/docs-v2/integrations/all/attio.mdx index c1ab64f2108..c3c927e3dd7 100644 --- a/docs-v2/integrations/all/attio.mdx +++ b/docs-v2/integrations/all/attio.mdx @@ -14,32 +14,84 @@ import PreBuiltUseCases from "/snippets/generated/attio/PreBuiltUseCases.mdx" ## Access requirements | Pre-Requisites | Status | Comment| | - | - | - | -| Paid dev account | ❓ | | -| Paid test account | ❓ | | -| Partnership | ❓ | | -| App review | ❓ | | -| Security audit | ❓ | | +| Paid dev account | ✅ Not required | Free, self-signup for an [Attio account](https://app.attio.com/sign-up). | +| Paid test account | ✅ Not required | Free account can be used for testing. | +| Partnership | ✅ Not required | | +| App review | ✅ Not required | | +| Security audit | ✅ Not required | | ## Setup guide -_No setup guide yet._ + + + 1. Go to the [Attio sign-up page](https://app.attio.com/sign-up). + 2. Enter your email address, name, and create a password. + 3. Complete the account setup process. + + + 1. Log in to your Attio account. + 2. Navigate to **Settings > Developers** in your Attio workspace. + 3. Click on **Create integration**. + 4. Enter a name for your integration. + 5. Click **Create** to generate your integration. + + + 1. In your integration settings page, locate the **OAuth 2.0** section. + 2. Add `https://api.nango.dev/oauth/callback` as a redirect URI. + 3. Save your changes. + + + 1. In your integration settings, navigate to the **Scopes** section. + 2. Select the appropriate scopes for your integration needs: + - **Object configuration**: For access to object configuration data + - **Record read**: For read access to records + - **Record write**: For write access to records + - **List read**: For read access to lists + - **List write**: For write access to lists + 3. Save your scope configuration. + + + 1. In your integration settings page, locate the **Client ID** and **Client Secret**. + 2. Copy these values as you'll need them when configuring your integration in Nango. + + Note: Keep your Client Secret secure and never expose it in client-side code. + + + When setting up your Attio integration in Nango: + + - Use your **Client ID** and **Client Secret** from the previous step + - For the authorization URL, use: `https://app.attio.com/authorize` + - For the token URL, use: `https://app.attio.com/oauth/token` + + + 1. After configuring your integration in Nango, test the OAuth flow to ensure it works correctly. + 2. The authorization flow will redirect users to Attio where they can approve access to their workspace. + 3. After approval, users will be redirected back to your application with an authorization code. + + + Follow the [_Quickstart_](/getting-started/quickstart). + + Need help getting started? Get help in the [community](https://nango.dev/slack). -Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/attio.mdx) - ## Useful links - [How to register an Application](https://developers.attio.com/docs/integrations) - [OAuth-related docs](https://developers.attio.com/reference/using-oauth) -- [Rate limiting](https://developers.attio.com/docs/rate-limiting) -- [API docs](https://developers.attio.com/reference/get_v2-objects) - Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/attio.mdx) +## Common Scopes + +- **object_configuration**: Access to object configuration data +- **record_read**: Read access to records +- **record_write**: Write access to records +- **list_read**: Read access to lists +- **list_write**: Write access to lists + ## API gotchas -Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/attio.mdx) \ No newline at end of file +Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/attio.mdx)