v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Connections

Create Connection

Create a new user-provided connection (custom MCP server) for the current team. OAuth-based integrations (native) require an interactive browser flow — start them with the dedicated OAuth endpoints (/v2/teams/:team_id/connections/oauth/native/:provider/start or /v2/teams/:team_id/connections/oauth/mcp/start) instead of calling this endpoint directly.

post/v2/teams/{teamId}/connections

Path parameters

teamIdstring required

Request body

namestring required

server_urlstring uri

typestring

provider'user' required

auth_method'url' | 'apikey' | 'headers' | 'oauth' required

custom_integration_idstring uuid

Response

Default Response

idstring required

namestring required

typestring required

providerstring required

user_idstring nullable required

team_idstring required

server_urlstring

transport_type'stdio' | 'sse' | 'http'

auth_methodstring nullable

custom_integration_idstring nullable

icon_urlstring nullable

oauth_providerstring nullable

oauth_provider_keystring nullable

oauth_scopesstring[] nullable

has_headersboolean

has_oauth_tokensboolean

integration_idstring nullable

sharedboolean

created_bystring nullable

broken_atstring date-time nullable

broken_reasonstring nullable

created_atstring date-time required

updated_atstring date-time required