> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

Before we can get started with development, there's a bit of setup to do. Please follow the steps below carefully so that you won't have any issues down the line.

## Log into the dashboard

Log into the Kombo dashboard. You should have received an **invite via email** but if you didn't, **reach out** to your team members or to Kombo directly via Slack/Teams

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-kombo-dashboard.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=f514014b15845bddd1a3b8ac560ea279" alt="1376" width="2940" height="1660" data-path="images/ta-kombo-dashboard.png" />

## Integration configuration

Go to the [tools overview](https://app.kombo.dev/tools) and select / deselect all integrations that you want to offer. You can change this at any time.

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-integration-conf.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=f16460815beaa8bba56d3f6384bdcefd" alt="1376" width="1471" height="834" data-path="images/ta-integration-conf.png" />

## Scope configuration

Go to the [scopes overview](https://app.kombo.dev/scope-config) and click on "**New config**" or "**Edit**" an existing one.

<img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-scope-conf.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=ed7bc11791430c346750eb51fb91ba29" alt="1376" width="2940" height="1666" data-path="images/ta-scope-conf.png" />

Select the data models that you need and click on "**Save changes**".

<img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-scope-save-change.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=6eb53aaa97323e7f5f52917e46235f30" alt="1376" width="1120" height="1542" data-path="images/ta-scope-save-change.png" />

<Note>
  🦉 These scopes are **just for development**. To understand more about this feature and how to use it to evoke a great first impression with customers, [read more here](/ats/features/scopes).
</Note>

## Set up a linked account for development

To call the API you always need to have a linked ATS account to pull and push data from. You can either [get yourself a sandbox via a free trial](/ats/getting-started/sandbox-integrations), or use our built-in mock integration to get started faster (recommended).

Go to the [integrations tab](https://app.kombo.dev/integrations) and click on "**Create a sandbox integration**".

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-create-sandbox.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=8364d511fa53089caf19c694529c3d43" alt="1376" width="2940" height="1604" data-path="images/ta-create-sandbox.png" />

Click "**Continue**" and "**Set up integration**".

<div style={{ display: 'flex', justifyContent: 'space-between', gap: '1rem' }}>
  <img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-setup-sandbox-1.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=8a948bdf66c792450f63bf6b952d2994" alt="First Image Description" width="694" height="1226" data-path="images/ta-setup-sandbox-1.png" />

  <img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-setup-sandbox-2.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=7e0d400325786f9e5440df6da1793c67" alt="Second Image Description" width="718" height="1246" data-path="images/ta-setup-sandbox-2.png" />

  <img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-setup-sandbox-3.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=c342211a0aa533156b9cabdbdf358adb" alt="Third Image Description" width="730" height="1256" data-path="images/ta-setup-sandbox-3.png" />
</div>

**Click** on the tile that just appeared to get to the details page of the integration.

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-integration-details.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=dc69e114f21f702856d33541988c8514" alt="1376" width="1610" height="544" data-path="images/ta-integration-details.png" />

On this page, you can find all info related to the integration. For now, we will only need the integration ID though.

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-integration-details-1.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=255c52cce84641170c7f16921bd67a71" alt="Integration details 1.png" width="500" data-path="images/ta-integration-details-1.png" />

## Create Kombo API key

Go to the [Secrets tab](https://app.kombo.dev/secrets) and click on "**New API key**".

<img src="https://mintcdn.com/kombo/Rjeo5fuDzUBK3i-0/images/ta-secrets-tab.png?fit=max&auto=format&n=Rjeo5fuDzUBK3i-0&q=85&s=4a0154f6b12cd5223c4cfafab57839bc" alt="1376" width="2938" height="1136" data-path="images/ta-secrets-tab.png" />

Name the API key and click "**Create API key**".

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-create-key.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=c57c508e236ea4d9764bc2fdae79bc38" alt="Create API key.png" width="400" data-path="images/ta-create-key.png" />

Copy the token and store it somewhere safe.

<img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-copy-key.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=4c5f8e2300a88c497dadf43d36023fca" alt="Create API key.png" width="450" data-path="images/ta-copy-key.png" />

## Test your setup

🎉 You made it through the setup and have everything in place to get started developing 🎉

To verify you set up the sandbox integration and API key correctly, try the following HTTP request to the ["get integration details"-endpoint](/ats/v1/get-integrations-integration-id)

```bash theme={null}
curl --request GET \
  --url https://api.kombo.dev/v1/integrations/{integration_id} \
  --header 'Authorization: <api_key>'
```

You can also use any other endpoint like ["get jobs"](/ats/v1/get-jobs) or ["create application"](/ats/v1/post-jobs-job-id-applications). The Sandbox integration will return you some sample data for it.

<Tip>
  **Tip:** You can use our [official server-side SDKs](/libraries-and-sdks) to
  interact with the Kombo API in an ergonomic and type-safe manner. Check if
  your tech stack is already supported!
</Tip>

## Optional: set up Postman collection

To make development easier, we recommend setting up a Postman collection. It takes only one minute and can be done like this:

* **Copy** the link of our OpenAPI schema:

  ```bash theme={null}
  https://api.kombo.dev/openapi.json
  ```

* Open Postman, and click **Import**
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-postman-import.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=b24e1846db950a04d35677857f2d22c2" alt="1376" width="944" height="284" data-path="images/ta-postman-import.png" />

* **Paste** the URL and click **Import**

  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-postman-url.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=693ba329cec010a679ec17b0f7ad02d2" alt="Postman URL.png" width="450" data-path="images/ta-postman-url.png" />

  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/ta-postman-collection.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=c2d478d992683e7f9a39af15be36d8f4" alt="Postman Collection.png" width="500" data-path="images/ta-postman-collection.png" />
