Create a link session for a toolkit in a tool router session

Initiates an authentication link session for a specific toolkit within a tool router session. Returns a link token and redirect URL that users can use to complete the OAuth flow.

Authentication

x-api-keystring

API key authentication

Path parameters

session_idstringRequiredformat: "toolRouterSessionId"

The unique identifier of the tool router session

Request

This endpoint expects an object.

toolkitstringRequired>=1 character

The unique slug identifier of the toolkit to connect

callback_urlstringOptionalformat: "uri"

URL where users will be redirected after completing auth

Response

Successfully created link session. Returns link token, redirect URL, and connected account ID.

link_tokenstring

Token used to complete the authentication flow

redirect_urlstringformat: "uri"

The URL where users should be redirected to complete OAuth

connected_account_idstringformat: "connectedAccountId"

The unique identifier for the connected account

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/tool_router/session/trs_LX9uJKBinWWr/link"
4
5	payload = { "toolkit": "github" }
6	headers = {
7	"x-api-key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"link_token": "lt_abc123xyz",
3	"redirect_url": "https://app.composio.dev/link/lt_abc123xyz",
4	"connected_account_id": "ca_abc123xyz"
5	}

Authentication

Path parameters

Request

Response

Errors