Overview of Integrations

Integrations allow users to link their accounts with external apps, enabling agents to take actions on their behalf. You can view all active integrations and monitor live connections or users by visiting the Dashboard.

Integrations are tool configurations (eg. Permissions to ask for when connecting an account, ClientID/Secret in the case of OAuth) that will be used to connect your users account to Composio. You can use your own configuration or use Composio’s default integrations.

Once an integration is established, it can be utilized by an unlimited number of users to connect their accounts. So ideally you will only build one integration per tool or application and allow all your users to connect using it.

To authenticate users with a specific tool, create a new integration by selecting the desired tool on the Tools Page. Integrations can be established using either default credentials or by registering a new developer application and setting the necessary authentication and permission scopes.

Creating a New Integration (~ 2️⃣ πŸ•°οΈ minutes )

To facilitate actions on behalf of your users, start by selecting the app you want to integrate.


Selecting the Preferred Tool

In this guide, we will select β€˜Slack’ from the available default tools. Go to the tools page, select Slack, and click the β€˜Setup’ button in the upper right corner.


Configuring the Integration

Integrating tools that use OAuth or similar authentication methods typically requires registering a developer application. Composio provides default credentials for quick setup. However, for a more customized user experience, where the authorization page displays β€œAuthorizing YOURAPP” instead of β€œAuthorizing Composio,” you should register your own application and enter the required credentials.


Finalizing the Integration

Assign a name to your integration and save your integration. Upon saving, you will be directed to the integration’s page. Here, locate the integration ID, which is essential for referencing this integration in your application code.