Skip to main content
POST
/
connect
/
activate-integration
Activate integration (optional)
curl --request POST \
  --url https://api.kombo.dev/v1/connect/activate-integration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "token": "<string>"
}'
{
  "status": "success",
  "data": {
    "tool": "personio",
    "id": "personio:CBNMt7dSNCzBdnRTx87dev4E",
    "end_user_origin_id": "36123",
    "end_user_organization_name": "Acme, Inc.",
    "end_user_email": "[email protected]",
    "setup_status": "COMPLETED"
  }
}
We are deprecating this endpoint in favour of the get integration by code endpoint. To migrate you only have to change to the new API endpoint.

​
Example Request Body

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

Authorizations

​
Authorization
string
header
required

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

Body

application/json

POST /connect/activate-integration Request body

​
token
string
required

Response

POST /connect/activate-integration Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "tool": "personio",
  "id": "personio:CBNMt7dSNCzBdnRTx87dev4E",
  "end_user_origin_id": "36123",
  "end_user_organization_name": "Acme, Inc.",
  "end_user_email": "[email protected]",
  "setup_status": "COMPLETED"
}