Integrations
What are Integrations, how to create them and use them to connect user accounts
What is an Integration? (Controlling the OAuth Experience)
Integrations in Composio are configuration objects that define how your application connects to external services and APIs. Each integration encapsulates the authentication details, permissions, and API specifications needed to establish secure connections with services like GitHub, Slack, or HubSpot.
Integrations include critical configuration like OAuth credentials (Client ID/Secret), required permissions scopes, and API endpoint specifications that determine how your users can interact with the external service.
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 an Integration
- 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
- Then Click on “Connect to [App Name]” and Authenticate with your Account
- Congratulations! Integration was successful!
Fetching all 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.
Whitelabeling the OAuth Developer App Using Integrations
Integrations can be used to customise the OAuth Developer App that is shown to the user when initiating a connection.
Create an Integration and toggle on “Use your own Developer App”
Enter your ClientID and ClientSecret and save the integration.
Now you can use this integration and the user in auth flow should see the custom developer app.
Was this page helpful?