---
title: "Activate integration (optional)"
method: POST
path: "/connect/activate-integration"
tags: ["Kombo Connect"]
---

# Activate integration (optional)

`POST /connect/activate-integration`

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. You do not need to call this endpoint for an integration to become active.

<Warning>We are deprecating this endpoint in favour of the [get integration by code endpoint](/v1/get-integration-by-token-token). To migrate you only have to change to the new API endpoint.</Warning>

### Example Request Body

```json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXNzYWdlIjoiVGhpcyBpcyBub3QgYW4gYWN0dWFsIHRva2VuLiJ9.JulqgOZBMKceI8vh9YLpVX51efND0ZyfUNHDXLrPz_4"
}
```

## Request body

- PostConnectActivateIntegrationRequestBody
  - `token` string, required

## Response `200`

POST /connect/activate-integration Positive response

- PostConnectActivateIntegrationPositiveResponse
  - `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/1e45035b96d3/schema)