Connect Composio Integration

Finalize a Composio-backed connection after the start step (/v2/teams/:team_id/connections/composio/start) has produced a connected_account_id. Provisions a Composio MCP server bound to that account and persists the connection on the team. Works for both OAuth and non-OAuth start flows. Stale or invalid connected_account_id, missing app, or rejected upstream input surfaces as a 4xx via composioErrorFor; only genuinely unexpected upstream/persistence failures return 5xx.

POST /v2/teams/{teamId}/connections/composio/finalize

Connect Composio Integration

cURL

curl --request POST \
  --url https://api.duvo.ai/v2/teams/{teamId}/connections/composio/finalize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "app": "<string>",
  "integration_name": "<string>",
  "connected_account_id": "<string>"
}
'

201

{
  "integration_id": "<string>",
  "mcp_url": "<string>"
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId · string · required

Body

application/json

app · string · required

Composio app slug (e.g. 'slack', 'googlesheets'). Must match a Composio toolkit configured for the team.

Minimum string length: 1

integration_name · string · required

Human-readable name to display for the connection.

Minimum string length: 1

connected_account_id · string · required

Composio connected-account ID returned by /v2/teams/:team_id/connections/composio/start. Used to bind this finalize call to the exact account the user just authorized; without it the wrong account could be picked when the team has multiple Composio accounts for the same app.

Minimum string length: 1

Response

201

application/json

Default Response

integration_id · string · required

mcp_url · string · required