> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/integrations/integrations/topdesk/set-up-topdesk.md).

# Set up TOPdesk

Connect **OutSmart** to **TOPdesk** before you configure any import or export options.

You need an operator username, an application password, and your TOPdesk domain.

### Before you start

Make sure you have:

* activated the integration in the **License Manager**
* access to your **TOPdesk operator account**
* permission to generate a **TOPdesk application password**
* access to **Settings → General → Software integrations** in OutSmart

{% stepper %}
{% step %}

### Generate an application password in TOPdesk

Sign in to **TOPdesk**.

Open your user settings.

Generate an **Application Password**.

Copy the password.
{% endstep %}

{% step %}

### Open the TOPdesk integration

Sign in to the **OutSmart BackOffice**.

Go to **Settings → General → Software integrations**.

Open **TOPdesk**.

Open **Settings**.
{% endstep %}

{% step %}

### Enter the login details

Fill in these fields:

* **Operator username**
* **Application password**
* **Domain**
  {% endstep %}

{% step %}

### Submit the connection

Click **Submit**.

OutSmart verifies the details with TOPdesk.
{% endstep %}

{% step %}

### Configure import and export settings

After a successful login, the TOPdesk settings page opens.

Choose which data you want to import and export.
{% endstep %}

{% step %}

### Save the setup

Click **Save**.

Your connection and sync settings are then stored.
{% endstep %}
{% endstepper %}

### What OutSmart creates during setup

When you connect TOPdesk for the first time, OutSmart creates two work order statuses:

* **To TOPdesk**
* **Not to TOPdesk**

Use **To TOPdesk** for work orders linked to a TOPdesk call.

Use **Not to TOPdesk** for work orders that should stay outside the TOPdesk flow.

### Important to know

* The **domain** should be your TOPdesk address, such as `yourcompany.topdesk.net`.
* OutSmart uses the **application password** for the connection.
* Your personal TOPdesk login password is not stored.
* You can disconnect the integration from the settings page.

### Frequently asked questions

<details>

<summary>Where do I find the application password in TOPdesk?</summary>

Open your TOPdesk user profile settings.

Look for the option to generate an **Application Password**.

If needed, check the TOPdesk documentation or the PDF manual linked on the settings page.

</details>

### Related topics

* [**TopDesk**](/integrations/integrations/topdesk.md)
* [**What is TOPdesk?**](/integrations/integrations/topdesk/what-is-topdesk.md)
* [**Configure TOPdesk imports**](/integrations/integrations/topdesk/configure-topdesk-imports.md)
* [**Configure TOPdesk exports**](/integrations/integrations/topdesk/configure-topdesk-exports.md)
* [**Set up a software integration**](/integrations/integrations/set-up-a-software-integration.md)

<details>

<summary>What happens if the login details are wrong?</summary>

OutSmart shows an error.

Check the operator username, application password, and domain.

Then submit the connection again.

</details>

<details>

<summary>What does an error about missing status or operator group permissions mean?</summary>

The TOPdesk account cannot read processing statuses or operator groups through the API.

Ask your TOPdesk administrator to grant the required API permissions.

</details>

<details>

<summary>How do I disconnect TOPdesk?</summary>

Use the disconnect button with the power icon in the log panel.

You can find it on the right side of the settings page.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/integrations/integrations/topdesk/set-up-topdesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.