Guide

Create Project

Overview

Composio projects are the foundation of multi-tenant organization in Composio. Each project provides an isolated environment where you can manage API keys, connected user accounts, and authentication configurations independently. Creating a new project is the first step when you need a separate workspace—for example, to isolate development from production, or to manage distinct client integrations. This workflow walks you through the dashboard interface to set up your new project with a descriptive name.

Before you begin

  • Active Composio account with access to dashboard.composio.dev
  • Organization membership (projects exist within an organization)
  • Project name chosen (must be meaningful for your use case, e.g., 'Production API', 'Client Portal Dev')

Step by step

1
ClickDProject demotest

Click on the current project selector (labeled 'DProject demotest' or similar) in the dashboard to open the project menu. This displays your existing projects and provides access to project management options.

Tip. The project selector is typically located in the top-left or top navigation area of the dashboard.
Step 1
2
TypeFind Project...

Type in the search field labeled 'Find Project...' to filter existing projects or locate the project creation option. This helps you quickly navigate the project list.

Tip. You can leave this field empty to see all available options, or begin typing your intended project name.
3
ClickCreate Project

Click the 'Create Project' button to open the project creation dialog. This button becomes available in the project menu and initiates the workflow for setting up a new isolated project environment.

Tip. If you don't see this button, ensure the project menu is fully expanded and you have organization permissions to create projects.
Step 3
4
TypeProject name

Type your project name in the 'Project name' text field. Use a descriptive name that reflects the project's purpose (e.g., 'Production API', 'Staging Environment', or 'Client Integration').

Tip. Avoid special characters and keep the name concise and memorable. You can update the project name later in project settings if needed.
5
ClickCreate project

Click the 'Create project' button to finalize and create your new project. This commits the project to your organization and initializes the isolated environment.

Tip. After creation, the dashboard will automatically switch to your new project, and you can immediately begin configuring API keys and connected accounts.
Warning. Ensure your project name is correct before clicking, as you'll need to manage it afterward through project settings.
Step 5

Confirm it worked

  1. 1New project appears in your project list on the dashboard with the name you specified
  2. 2Dashboard displays the new project as the active/selected project
  3. 3You are able to view project-specific settings, API keys, and configuration options for the newly created project

Common issues

Keep reading