Building shared integrations

If you are building an integration between your own product and Attio, we provide a publication process to make your integration available to other Attio users.

Developer workspaces

When building a shared integration with Attio, the first thing to do is to create a new workspace to host your application. Shared integrations must not be hosted inside your main Attio workspace if you are a customer. Our team is able to spin up a new developer workspace with seeded test data. Alternatively, you are welcome to get started right away with a free trial account. We recommend naming your workspace "[your company name] development".

To allow you to develop and maintain your integrations without running into billing issues, Attio offers a free developer plan. To be invited to a seeded developer workspace or access this billing plan, please reach out to our team via the chat widget at the bottom right of the page.

You must not run any real business processes or use real customer data in workspaces on the developer plan. See section 4.5 in Ts&Cs. Content inside a developer workspace may also be reset periodically.

Authentication

We strongly recommend using OAuth to authenticate your app. This will ensure that users have a streamlined install flow to your integration, and will also allow us to showcase your app inside our integration store. Please note that only workspace admins will be able to approve OAuth flows for your integration.

For more information about configuring OAuth for your integration, please check out our OAuth guides.

When in development, OAuth access may be granted to the workspace you are developing the integration in, but will not work across different workspaces. In order to provide your integration to other workspaces, you will need to publish the integration first.

Publication

When you're ready to share your work with the wider world, you may request publication from the Attio team so that your integration can be used by all workspaces. You can do this at the bottom of your integration's settings page. From this point, our team will be in touch to help ensure your integration meets all requirements and collaborate on any documentation and co-marketing as appropriate.

Promotion

For some integrations, we may also be able to offer the opportunity for cross-promotion in our integration store, social media and help docs. Please reach out to our team once your integration has been built to find out more.