Sign in

v3

OpenAPI 3.1.02026-07-311255771.3 MB
Kombo Connect

Get integration by token

Use this endpoint with the token you get from the connection flow to retrieve information about the created integration.

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.

get/connect/integration-by-token/{token}

Path parameters

tokenstring required

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

Response

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

status'success' required

Example response

{
  "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"
  }
}