---
title: "Get integration by token"
method: GET
path: "/connect/integration-by-token/{token}"
tags: ["Kombo Connect"]
---

# Get integration by token

`GET /connect/integration-by-token/{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](/connect/embedded-flow) 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.

## Path parameters

- `token` string, required

## Response `200`

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

- GetConnectIntegrationByTokenTokenPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `tool` string, required
    - `id` string, required
    - `end_user_origin_id` string, nullable, required
    - `end_user_organization_name` string, required
    - `end_user_email` string, nullable, required
    - `setup_status` 'INCOMPLETE' | 'FINAL_SYNC_PENDING' | 'COMPLETED', required — The setup_status is used in conjunction with the filtering and field mapping features. If these are enabled in the connection flow, the integration will start in an "INCOMPLETE" state and move to "COMPLETE" once all steps are finished. - `INCOMPLETE`: Setup is still in progress. Some steps aren’t finished, so no data is available yet. Syncs only run as needed for setup. - `FINAL_SYNC_PENDING`: Setup is complete, and the final sync is running. Data will be available after this sync is done. - `COMPLETED`: Setup is fully finished, and the integration is ready to use.

## Other responses

- `default` — The standard error response with just the platform error codes.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/149bf44faf1a/schema)