Kombo Docs

https://docs.kombo.dev
Admin
Kombo offers unified APIs for HR Tech, allowing developers to build integrations faster and more...
Tokens:1,092,087
Snippets:8,412
Trust Score:8.2
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### 200 response example for create provisioning setup link

Source: https://docs.kombo.dev/assessment/v1/post-hris-provisioning-groups-group-id-setup-links

Example success response (200) for the create provisioning setup link request. Contains the setup URL and its expiration timestamp.

```json
{
  "status": "success",
  "data": {
    "url": "https://connect.kombo.dev/v1/setup?token=GinuMJCpUQ9xdpLmD2ocw8qdiK3qiPCizDCv754EXri2vAX4",
    "expires_at": "2023-10-11T12:00:00.000Z"
  }
}
```

--------------------------------

### Example response data object for setup link

Source: https://docs.kombo.dev/lms/v1/post-hris-provisioning-groups-group-id-setup-links

Example of the data object in the response, showing the setup link URL and its expiration time.

```json
{  
  "url": "https://connect.kombo.dev/v1/setup?token=GinuMJCpUQ9xdpLmD2ocw8qdiK3qiPCizDCv754EXri2vAX4",  
  "expires_at": "2023-10-11T12:00:00.000Z"  
}

```

--------------------------------

### Example response for setup link creation

Source: https://docs.kombo.dev/lms/v1/post-hris-provisioning-groups-group-id-setup-links

Example JSON response from the setup-links endpoint. Contains a status of 'success' and a data object with the setup link URL and its expiration time.

```json
{ "status": "success", "data": { "url": "https://connect.kombo.dev/v1/setup?token=GinuMJCpUQ9xdpLmD2ocw8qdiK3qiPCizDCv754EXri2vAX4", "expires_at": "2023-10-11T12:00:00.000Z" } }
```

--------------------------------

### Go net/http example for GET rejection-reasons

Source: https://docs.kombo.dev/ats/v1/get-rejection-reasons

Go example using net/http to call the GET /v1/ats/rejection-reasons endpoint. It adds the required headers and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/ats/rejection-reasons"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Integration-Id", "<x-integration-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### JavaScript fetch example for creating setup link

Source: https://docs.kombo.dev/ats/v1/post-hris-provisioning-groups-group-id-setup-links

JavaScript example using fetch to POST to the setup-links endpoint. Uses the same headers and body as other examples.

```JavaScript
const options = {
  method: 'POST',
  headers: {
    'X-Integration-Id': '<x-integration-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({language: 'en'})
};

fetch('https://api.kombo.dev/v1/hris/provisioning-groups/{group_id}/setup-links', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

```

--------------------------------

### Example 200 Response for Get Integration by Token

Source: https://docs.kombo.dev/assessment/v1/get-connect-integration-by-token-token

Example success response for the Get Connect Integration by Token endpoint. Shows the structure with status and data fields, including the tool, integration ID, end user details, and setup status.

```json
{
  "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",
    "setup_status": "COMPLETED"
  }
}
```

--------------------------------

### Ruby Net::HTTP example for creating setup link

Source: https://docs.kombo.dev/ats/v1/post-hris-provisioning-groups-group-id-setup-links

Ruby example using Net::HTTP to POST to the setup-links endpoint. Sets the same headers and body, and prints the response.

```Ruby
require 'uri'
require 'net/http'

url = URI("https://api.kombo.dev/v1/hris/provisioning-groups/{group_id}/setup-links")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Integration-Id"] = '<x-integration-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"language\": \"en\"\n}"

response = http.request(request)
puts response.read_body

```

--------------------------------

### Create setup link via HTTP API (cURL, JavaScript, PHP, Go, Java)

Source: https://docs.kombo.dev/assessment/v1/post-integrations-integration-id-setup-link

HTTP request examples for the POST `/v1/integrations/{integration_id}/setup-link` endpoint. They send a JSON body with `language` set to `en` and `link_type` set to `EMBEDDED`, using the Authorization header with a bearer token. The cURL example uses the `--request POST` flag; the JavaScript example uses `fetch`; the PHP example uses cURL with error handling; the Go example uses `http.NewRequest`; the Java example uses Unirest.

```bash
curl --request POST \
  --url https://api.kombo.dev/v1/integrations/{integration_id}/setup-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "language": "en",
  "link_type": "EMBEDDED"
}
'
```

```javascript
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({language: 'en', link_type: 'EMBEDDED'})
};

fetch('https://api.kombo.dev/v1/integrations/{integration_id}/setup-link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kombo.dev/v1/integrations/{integration_id}/setup-link",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'language' => 'en',
    'link_type' => 'EMBEDDED'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/integrations/{integration_id}/setup-link"

	payload := strings.NewReader("{\n  \"language\": \"en\",\n  \"link_type\": \"EMBEDDED\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.post("https://api.kombo.dev/v1/integrations/{integration_id}/setup-link")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"language\": \"en\",\n  \"link_type\": \"EMBEDDED\"\n}")
  .asString();
```

--------------------------------

### Response data object example for GET /custom/datev/system-information

Source: https://docs.kombo.dev/hris/v1/get-datev-system-information

Example data object shown in the response schema documentation for the GET /custom/datev/system-information endpoint. Contains the same fields as the full response example.

```json
{  
  "consultant_number": 1234567,  
  "client_number": 99999,  
  "target_system": "LODAS"  
}
```

--------------------------------

### Response: 200 Example

Source: https://docs.kombo.dev/assessment/v1/post-integrations-integration-id-setup-link

Example successful response with status 'success' and a data object containing the setup link.

```json
{ "status": "success", "data": { "link": "<string>" } }
```

--------------------------------

### Positive Response Example for GET /hris/employees/form

Source: https://docs.kombo.dev/hris/v1/get-employees-form

Example response body for the GET /hris/employees/form endpoint. Shows the returned form properties with additional fields like reg_exp and the same structure as the request example.

```json
{  
  "properties": {  
    "firstName": {  
      "label": "First Name",  
      "required": true,  
      "description": "Employee's first name",  
      "unified_key": "first_name",  
      "type": "text",  
      "min_length": 1,  
      "max_length": 100,  
      "reg_exp": null  
    },  
    "startDate": {  
      "label": "Start Date",  
      "required": true,  
      "description": "Employee's start date",  
      "unified_key": "start_date",  
      "type": "date"  
    },  
    "workLocation": {  
      "label": "Work Location",  
      "required": false,  
      "description": "Employee's work location",  
      "unified_key": null,  
      "type": "object",  
      "properties": {  
        "site": {  
          "label": "Site",  
          "required": true,  
          "description": "Employee's site",  
          "unified_key": null,  
          "type": "single_select",  
          "options": {  
            "type": "inline",  
            "entries": [  
              {  
                "id": "FXrER44xubBqA9DLgZ3PFNNx",  
                "label": "Site 1",  
                "unified_value": "1",  
                "remote_id": "site_1"  
              },  
              {  
                "id": "2rv75UKT2XBoQXsUb9agiTUm",  
                "label": "Site 2",  
                "unified_value": "2",  
                "remote_id": "site_2"  
              }  
            ]  
          }  
        },  
        "keyNumbers": {  
          "label": "Key Numbers",  
          "required": false,  
          "description": "Employee's key numbers",  
          "unified_key": null,  
          "type": "array",  
          "item_type": {  
            "label": "Key Number",  
            "required": false,  
            "description": "The number of the keys which belong to the employee",  
            "unified_key": null,  
            "type": "number",  
            "min": 0,  
            "max": 99  
          },  
          "min_items": 2,  
          "max_items": 5  
        }  
      }  
    }  
  }  
}
```

--------------------------------

### Example 200 response for Get users

Source: https://docs.kombo.dev/lms/v1/get-users

Example 200 response for GET /v1/lms/users. Shows a success status with a pagination cursor and a user object.

```json
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "26vafvWSRmbhNcxJYqjCzuJg",
        "remote_id": "32",
        "first_name": "Sarah",
        "last_name": "Johnson",
        "work_email": "sarah.johnson@example.com",
        "status": "ACTIVE",
        "remote_created_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_data": null,
        "custom_fields": null,
        "integration_fields": []
      }
    ]
  }
}
```

--------------------------------

### Python requests example for creating setup link

Source: https://docs.kombo.dev/ats/v1/post-hris-provisioning-groups-group-id-setup-links

Python example using the requests library to POST to the setup-links endpoint. Includes the same headers and payload as the cURL example.

```Python
import requests

url = "https://api.kombo.dev/v1/hris/provisioning-groups/{group_id}/setup-links"

payload = { "language": "en" }
headers = {
    "X-Integration-Id": "<x-integration-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

```

--------------------------------

### Java Unirest example for GET rejection-reasons

Source: https://docs.kombo.dev/ats/v1/get-rejection-reasons

Java Unirest example for the GET /v1/ats/rejection-reasons endpoint. It sets the required headers and returns the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.kombo.dev/v1/ats/rejection-reasons")
  .header("X-Integration-Id", "<x-integration-id>")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Create setup link with Kombo SDKs (Python, TypeScript, Ruby)

Source: https://docs.kombo.dev/assessment/v1/post-integrations-integration-id-setup-link

SDK examples for creating a setup link with the Kombo SDKs. They use the `general.create_setup_link` method (or `createSetupLink` in TypeScript) with the integration ID `personio:93fCvorjZ2jas7ZekX1V1n5d`, link type `EMBEDDED`, and language `en`. The Python example uses a context manager and prints the response; the TypeScript example uses an async function; the Ruby example checks for a positive response object.

```python
from kombo import Kombo


with Kombo(
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as k_client:

    res = k_client.general.create_setup_link(integration_id="personio:93fCvorjZ2jas7ZekX1V1n5d", link_type="EMBEDDED", language="en")

    # Handle response
    print(res)
```

```typescript
import { Kombo } from "@kombo-api/sdk";

const kombo = new Kombo({
  api_key: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await kombo.general.createSetupLink({
    integration_id: "personio:93fCvorjZ2jas7ZekX1V1n5d",
    body: {
      link_type: "EMBEDDED",
    },
  });

  console.log(result);
}

run();
```

```ruby
require 'kombo'

Models = ::Kombo::Models
s = ::Kombo::Kombo.new(
  security: Models::Shared::Security.new(
    api_key: '<YOUR_BEARER_TOKEN_HERE>'
  )
)
res = s.general.create_setup_link(integration_id: 'personio:93fCvorjZ2jas7ZekX1V1n5d', body: Models::Shared::PostIntegrationsIntegrationIdSetupLinkRequestBody.new(
  link_type: Models::Shared::PostIntegrationsIntegrationIdSetupLinkRequestBodyLinkType::EMBEDDED
))

unless res.post_integrations_integration_id_setup_link_positive_response.nil?
  # handle response
end
```

--------------------------------

### Get Employments via HTTP (curl, fetch, PHP, Go, Java)

Source: https://docs.kombo.dev/hris/v1/get-employments

HTTP client examples for the GET /v1/hris/employments endpoint. All examples send a GET request to https://api.kombo.dev/v1/hris/employments with the required headers 'Authorization: Bearer <token>' and 'X-Integration-Id: <x-integration-id>'. The PHP example prints the response or a cURL error; the Go example reads and prints the response body; the Java example uses Unirest and returns an HttpResponse<String>.

```bash
curl --request GET \
  --url https://api.kombo.dev/v1/hris/employments \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'

```

```javascript
const options = {
  method: 'GET',
  headers: {'X-Integration-Id': '<x-integration-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.kombo.dev/v1/hris/employments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kombo.dev/v1/hris/employments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Integration-Id: <x-integration-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/hris/employments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Integration-Id", "<x-integration-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

```java
HttpResponse<String> response = Unirest.get("https://api.kombo.dev/v1/hris/employments")
  .header("X-Integration-Id", "<x-integration-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

```

--------------------------------

### PHP cURL example for GET rejection-reasons

Source: https://docs.kombo.dev/ats/v1/get-rejection-reasons

PHP cURL example for the GET /v1/ats/rejection-reasons endpoint. It sets the required headers and prints the response or a cURL error.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kombo.dev/v1/ats/rejection-reasons",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Integration-Id: <x-integration-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Go: Create setup link with net/http

Source: https://docs.kombo.dev/assessment/v1/post-integrations-integration-id-setup-link

Uses Go's net/http to POST to the setup-link endpoint with a JSON body. Requires an API token. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/integrations/{integration_id}/setup-link"

	payload := strings.NewReader("{\n  \"language\": \"en\",\n  \"link_type\": \"EMBEDDED\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### GET /hris/locations response example

Source: https://docs.kombo.dev/hris/v1/get-locations

Example response body for the GET /hris/locations endpoint. Shows the pagination cursor, a location record with address fields, and the remote_deleted_at timestamp.

```json
{
  "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
  "results": [
    {
      "id": "22st2Ji8XpncEYEak8mvQgQF",
      "remote_id": "1348",
      "name": "Kombo HQ",
      "address": {
        "city": "Berlin",
        "country": "DE",
        "raw": "Sonnenallee 63\n12045 Berlin, Berlin\nGermany",
        "state": "Berlin",
        "street_1": "Sonnenallee 63",
        "street_2": null,
        "zip_code": "12045"
      },
      "type": "OFFICE",
      "changed_at": "2022-08-07T14:01:29.196Z",
      "remote_deleted_at": "2022-08-07T14:01:29.196Z",
      "remote_data": null
    }
  ]
}
```

--------------------------------

### Create Career Site - Go Example

Source: https://docs.kombo.dev/ai-apply/v1/post-career-sites

Go example using net/http to POST to the career-sites endpoint. Requires an API key in the Authorization header and a JSON body with a 'label' field.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/ai-apply/career-sites"

	payload := strings.NewReader("{\n  \"label\": \"Acme Inc. California\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example response for GET /hris/absences

Source: https://docs.kombo.dev/hris/v1/get-absences

Example response for a successful GET request to /hris/absences. Shows the structure of the returned data, including pagination cursor and absence details.

```json
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "22st2Ji8XpncEYEak8mvQgQF",
        "remote_id": "1348",
        "employee_id": "JDdUy9kiH5APaGizFrgNmQjM",
        "approver_id": "AgXEispYPP1BbToHpqnqcpxy",
        "start_date": "2022-08-04",
        "end_date": "2022-08-05",
        "start_half_day": true,
        "end_half_day": false,
        "start_time": "13:15:00",
        "end_time": "17:00:00",
        "amount": 2,
        "unit": "DAYS",
        "status": "APPROVED",
        "employee_note": "Visiting my family.",
        "type_id": "xzZoKssDaMZAd62kxayzzQvD",
        "remote_created_at": "2022-08-07T14:01:29.196Z",
        "remote_updated_at": "2022-08-07T14:01:29.196Z",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": "2022-08-07T14:01:29.196Z",
        "remote_data": null,
        "type": {
          "id": "xzZoKssDaMZAd62kxayzzQvD",
          "remote_id": "91",
          "name": "Vacation",
          "unit": "DAYS",
          "half_days_supported": true,
          "exact_times_supported": false,
          "remote_data": null,
          "custom_fields": {},
          "integration_fields": [],
          "changed_at": "2022-08-07T14:01:29.196Z",
          "remote_deleted_at": null
        }
      }
    ]
  }
}
```

--------------------------------

### Example response: GET /v1/ats/interviews

Source: https://docs.kombo.dev/ats/v1/get-interviews

Example response for a successful GET /v1/ats/interviews request. Shows the structure of the returned data, including pagination cursor and interview details.

```json
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "26vafvWSRmbhNcxJYqjCzuJg",
        "remote_id": "32",
        "title": "Interview with John Doe",
        "starting_at": "2023-06-26T14:30:00.000Z",
        "ending_at": "2023-06-26T15:30:00.000Z",
        "location": {
          "city": "Berlin",
          "country": "DE",
          "raw": "Berlin, Germany",
          "state": "Berlin",
          "street_1": "Lohmühlenstraße 65",
          "street_2": null,
          "zip_code": "12435"
        },
        "video_conferencing_url": "https://meet.example.com/interview-abc123",
        "application_id": "H77fDF8uvEzGNPRubiz5DvQ7",
        "stage_id": "H5daSm8e85Dmvmne3wLeCPhX",
        "canceled": false,
        "remote_created_at": "2022-08-07T14:01:29.196Z",
        "remote_updated_at": "2022-08-07T14:01:29.196Z",
        "remote_data": null,
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "users": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "first_name": "John",
            "last_name": "Doe",
            "email": "john.doe@kombo.dev"
          }
        ],
        "application": {
          "id": "H77fDF8uvEzGNPRubiz5DvQ7",
          "remote_id": "32",
          "outcome": "HIRED",
          "rejection_reason_name": null,
          "candidate": {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "first_name": "John",
            "last_name": "Doe",
            "email_addresses": [
              {
                "email_address": "john.doe@example.com",
                "type": "PRIVATE"
              }
            ]
          },
          "job": {
            "id": "H5daSm8e85Dmvmne3wLeCPhX",
            "remote_id": "32",
            "name": "Backend Engineer"
          }
        }
      }
    ]
  }
}

```

--------------------------------

### 200 Response Example for POST /hris/provisioning-groups/{group_id}/setup-links

Source: https://docs.kombo.dev/assessment/v1/post-hris-provisioning-groups-group-id-setup-links

Example 200 response from the deprecated endpoint. Returns a setup URL and an expiration timestamp.

```json
{
  "status": "success",
  "data": {
    "url": "https://connect.kombo.dev/v1/setup?token=GinuMJCpUQ9xdpLmD2ocw8qdiK3qiPCizDCv754EXri2vAX4",
    "expires_at": "2023-10-11T12:00:00.000Z"
  }
}

```

--------------------------------

### JavaScript: Create setup link with fetch

Source: https://docs.kombo.dev/assessment/v1/post-integrations-integration-id-setup-link

Uses fetch to POST to the setup-link endpoint with a JSON body. Requires an API token. Logs the response or error.

```javascript
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({language: 'en', link_type: 'EMBEDDED'})
};

fetch('https://api.kombo.dev/v1/integrations/{integration_id}/setup-link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### JavaScript fetch example for GET rejection-reasons

Source: https://docs.kombo.dev/ats/v1/get-rejection-reasons

Use this JavaScript fetch example to call the GET /v1/ats/rejection-reasons endpoint. It requires the X-Integration-Id header and a Bearer token for authorization.

```javascript
const options = {
  method: 'GET',
  headers: {'X-Integration-Id': '<x-integration-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.kombo.dev/v1/ats/rejection-reasons', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Create a career site with Go

Source: https://docs.kombo.dev/ai-apply/v1/post-career-sites

Uses net/http to POST a JSON string with the label. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kombo.dev/v1/ai-apply/career-sites"

	payload := strings.NewReader("{\n  \"label\": \"Acme Inc. California\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```
Tokens:
Raw