Guides

Using custom auth configs

Some toolkits don’t have Composio managed authentication and require you to provide your own credentials. When Tool Router tries to use these toolkits, it will throw an error asking you to create an auth config.

1

Check if a toolkit needs custom credentials

In the Composio platform, go to “All Toolkits” and select the toolkit. If it shows no Composio managed auth schemes, you’ll need to create an auth config.

2

Create an auth config

  1. Go to Authentication management in the dashboard
  2. Click Create Auth Config
  3. Select the toolkit
  4. Choose the auth scheme (OAuth2, API Key, etc.)
  5. Enter your credentials (client ID, client secret, API key, etc.)
  6. Click Create

Copy the auth config ID (e.g., ac_1234abcd).

For detailed instructions on getting credentials for specific toolkits, see Custom auth configs.

3

Use in Tool Router

Pass your auth config ID when creating a session:

1session = composio.create(
2    user_id="user_123",
3    auth_configs={
4        "posthog": "ac_your_posthog_config"
5    }
6)

Tool Router will now use your auth config when users connect to this toolkit.