Guide

Create Composio API Key

Overview

Composio API keys are essential credentials that enable your applications to authenticate with Composio's platform and access its 1000+ integrated toolkits for AI agent development. By creating an API key through the dashboard, you generate a unique token that authorizes your application to make authenticated requests to Composio's services. This is a foundational step in setting up production applications that leverage Composio's tool search, context management, authentication, and sandboxed workbench capabilities. API keys should be treated as sensitive credentials—store them securely (e.g., in environment variables) and never commit them to version control.

Before you begin

  • Active Composio account with access to dashboard.composio.dev
  • Project created in Composio (navigate to your project first if multiple projects exist)
  • Administrator or Project Owner role to create API keys
  • Secure location prepared to store the API key (e.g., environment variable file, secrets manager)

Step by step

1
ClickPLATFORM T Project test Search ⌘K Getting Started Playground Toolkits Users Sessions Auth Configs Triggers Logs Support Documentation Settings Back to Project Search ⌘K PROJECT SETTINGS General API Keys Webhooks White Labeling Usage ORGANIZATION SETT

Click on the Settings section in the left sidebar navigation to access your project configuration options.

Tip. Look for 'Settings' in the PROJECT SETTINGS menu below General; it may be collapsed initially. Ensure you are selecting PROJECT SETTINGS (not ORGANIZATION SETTINGS) if you have access to both levels.
Step 1
2
ClickAPI Keys

Click on 'API Keys' from the settings submenu to navigate to the API key management page where you can create and manage your project's API keys.

Tip. The API Keys option is located in the PROJECT SETTINGS menu, alongside options like General, Webhooks, and White Labeling.
Step 2
3
ClickCreate API Key

Click the 'Create API Key' button to initiate the creation of a new API key.

Tip. If this button is disabled, verify that you have administrator or Project Owner permissions and that your session is active.
Step 3
4
TypeName

Enter a descriptive name for your API key in the 'Name' text field to identify its purpose (e.g., 'Production API Key', 'Development Key', 'Chat App Integration').

Tip. Use a name that clearly indicates the key's purpose or the application it serves, making it easier to manage multiple keys in the future.
5
ClickCreate

Click the 'Create' button to generate the new API key.

Step 5
6
ClickCopy API key

Click the 'Copy API key' button to copy your newly generated API key to your clipboard for immediate use in your application.

Tip. The API key is only displayed once for security reasons. Copy it immediately before closing this dialog or the key will not be retrievable.
Warning. Do not refresh the page or navigate away without copying the key first—you cannot retrieve it again after the dialog closes.
Step 6
7
ClickI Copied It

Click the 'I Copied It' button to confirm that you have successfully copied the API key and to dismiss the creation dialog.

Tip. This confirmation step ensures you acknowledge that the key has been copied before the dialog closes.
Step 7
8
TypeName

If you need to create additional API keys, enter a name for the next key in the 'Name' text field and repeat the creation process (steps 3–7), or save your current key and finish by securely storing it in your application's configuration or secrets manager.

Tip. Store your API key securely in an environment variable or secrets management system. Never hardcode it in your source code or commit it to version control.
Warning. Treat API keys as sensitive credentials equivalent to passwords. Rotate or regenerate keys periodically and immediately revoke any key that may have been compromised.

Confirm it worked

  1. 1API key is displayed in the dashboard with a 'Copy API key' button available
  2. 2You successfully copied the key to your clipboard (confirmed by 'I Copied It' button interaction)
  3. 3The new API key appears in your API Keys list on the dashboard
  4. 4You can retrieve the key later from the API Keys settings page (keys can be regenerated but not viewed again after initial creation)

Common issues

Keep reading