Skip to main content
POST
Create a custom toolkit

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Body

application/json

Toolkit to create

name
string
required

Display name of the toolkit

Required string length: 1 - 200
app_url
string<uri>
required

MCP server URL. Must use https.

auth_schemes
object[]
required

How users authenticate to the MCP server

Minimum array length: 1
user_id
required

"all" to share the toolkit with every user in the project, or a user ID to make it private to that user. "default" and other spellings of "all" (such as "ALL" or " all") are rejected. Cannot be changed after create.

Available options:
all
Example:

"all"

logo_file
object

Square PNG or JPEG logo, 256-1024px, max 3MB. Defaults to the Model Context Protocol logo.

callback_url
string<uri>

URL to send the user to after they connect. Used only for connect_link.

Response

Successfully created toolkit

slug
string
required

Slug of the created toolkit

Example:

"CUSTOM_NOTION_K7F2Q"

Link for a private toolkit's user to connect. Null for shared or no-auth toolkits, or if the link could not be created. To retry, call POST /api/v3.1/connected_accounts/link with an auth config for the toolkit, creating one with POST /api/v3.1/auth_configs if needed.