MCP tools

get_connect_sessionread only

Get a connect session

Checks whether a connect flow finished. Prefer the connection.completed webhook over polling this.

Category
Accounts
Calls
GET/v1/connect/sessions/{id}
Safe to auto-approve
Yes. It only reads data.

Parameters

idstringrequired

Connect session id. get_connect_url returns it, and the OAuth redirect carries it as `state`.

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

Example

A tool call as an MCP client would send it.

{
  "name": "get_connect_session",
  "arguments": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000"
  }
}