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

Recommended method to create an integration is via UI. (Only limited integrations are required)
One integration can be used by multiple users to connect their accounts.

  1. Login at Composio’s Website
  2. Go to the Tools section
  3. Click on any app you want to integrate
  4. Click on Setup on [App Name] Integration
  5. Choose your integration name and click Save
  6. Then Click on “Connect to [App Name]” and Authenticate with your Account
  7. 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.