GET
/
connect
/
integration-by-token
/
{token}
curl --request GET \
  --url https://api.kombo.dev/v1/connect/integration-by-token/{token} \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}

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
headerrequired

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

200 - application/json
status
enum<string>
required
Available options:
success
data
object
required
Create connection linkActivate integration (optional)