Composio Integration Guide

Overview

Composio enables Airweave to access credentials from integrated applications. When your users connect their accounts through Composio, Airweave can automatically retrieve those credentials for data synchronization.

Prerequisites

• A Composio account with API access
• Your Composio API key
• Connected user accounts in Composio for the sources you want to sync

Setup Guide

1
from airweave import AirweaveSDK
2
3
client = AirweaveSDK(api_key="YOUR_API_KEY")
4
5
# Create a Google Drive connection using Composio credentials
6
source_connection = client.source_connections.create(
7
    name="Sales Team Google Drive",
8
    short_name="google_drive",
9
    authentication={
10
        "provider_readable_id": "my-composio-connection-abc123",  # Your Composio auth provider id
11
        "provider_config": {
12
            "auth_config_id": "config_xyz789",  # From Composio dashboard
13
            "account_id": "account_abc123"      # From Composio dashboard
14
        }
15
    }
16
)
17
18
print(f"Created: {source_connection.name}")

How It Works

Field Mappings

Some sources use different field names between Airweave and Composio:

These mappings are handled automatically by Airweave.

Troubleshooting

No matching connection found

• Verify the auth_config_id and account_id are correct
• Ensure the account is connected in Composio
• Check that the integration type matches (e.g., google_drive vs googledrive)

Missing required auth fields

• The source may require additional fields not available in Composio
• Check the field mappings section above
• Contact support if a mapping is missing

Authentication failed

• Verify your Composio API key is valid
• Check if the user’s connection in Composio is still active
• Ensure the connected account has the necessary permissions

API Reference

For full API details, see the Source Connections API reference.