How To Configure Connections?
Learn how to configure connections for your users
What is an Integration?
Integrations in Composio are configuration objects that define how your application connects to external services (like GitHub, Slack, or HubSpot). Each integration encapsulates authentication credentials (OAuth Client ID/Secret), permission scopes, and API specifications that determine how your users can interact with the external service. These configuration objects are used to configure and manage connections with external services.
For example:
- When you create a GitHub integration, you specify OAuth authentication parameters and permission scopes like
repo:read
- This integration then serves as a reusable template - any user connecting their GitHub account through this integration will have the same standardized access level and authentication flow
- This ensures consistent and secure access patterns across your entire user base
Creating a New Integration
A single integration can be used by multiple users to connect their accounts. Ideally, create one integration per app unless you need different configurations for specific use cases.
- Login at Composio’s Website
- Go to the Tools section
- Click on any app you want to integrate
- Click on Setup on [App Name] Integration
- Choose your integration name and click Save
How to Fetch Integrations
Creating a new connection using an Integration
You can follow the same steps as mentioned in Creating a new connection and use integration object (Python) or integrationId (JavaScript).
Using Your Own OAuth Developer App
When creating an integration, you can use your own OAuth Developer App instead of Composio’s default one, you can follow the same steps as mentioned in Creating a New Integration and:
- Enable the toggle “Use your own Developer App”
- Enter your OAuth credentials:
- Client ID
- Client Secret
When users connect using this integration, they’ll see your app’s name and logo in the OAuth consent screen instead of Composio’s. Checkout the live demo here
Was this page helpful?