Skip to main content
GET
/
connect
/
integration-by-token
/
{token}
TypeScript
import { Kombo } from "@kombo-api/sdk";

const kombo = new Kombo({
  api_key: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await kombo.connect.getIntegrationByToken({
    token: "<value>",
  });

  console.log(result);
}

run();
{
  "status": "success",
  "data": {
    "tool": "personio",
    "id": "personio:CBNMt7dSNCzBdnRTx87dev4E",
    "end_user_origin_id": "36123",
    "end_user_organization_name": "Acme, Inc.",
    "end_user_email": "user@example.com",
    "setup_status": "COMPLETED"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt

Use this file to discover all available pages before exploring further.

It works in a similar way as the OAuth2 code flow to securely retrieve information and connect the integration to your user.
Check out our full guide for more details about implementing the connection flow into your app.
This endpoint is used to ensure users can’t trick your system connecting their account in your system to another customers integration. You don’t get the integration ID from the showKomboConnect(link) function but only the short lived token used for this endpoint so that users can’t send you arbitrary data that you would put into your system.

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Path Parameters

​
token
string
required

GET /connect/integration-by-token/:token Parameter

Response

GET /connect/integration-by-token/:token Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{
  "tool": "personio",
  "id": "personio:CBNMt7dSNCzBdnRTx87dev4E",
  "end_user_origin_id": "36123",
  "end_user_organization_name": "Acme, Inc.",
  "end_user_email": "user@example.com",
  "setup_status": "COMPLETED"
}