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.

  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

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:

  1. Enable the toggle “Use your own Developer App”
  2. 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