Overview

The TOPdesk node allows you to connect Flowmage with the TOPdesk REST API.

You can use this node to retrieve, create, or update data such as:

• Incidents

• Changes

• Persons

• Assets

? Ideal for IT service management and support automation.

When to Use This Node

Use the TOPdesk node when you want to:

• Retrieve incidents or tickets

• Create new incidents automatically

• Update ticket statuses

• Sync users or assets

• Integrate TOPdesk with other systems (AFAS, Entra ID, etc.)

Configuration

Connection Settings

Host

Your TOPdesk domain.

Example:

customer.topdesk.net

? Can also be a custom domain.

Username

Your TOPdesk API username.

Example:

api-user@company.com

Application Password

Your TOPdesk application password.

? This is not your normal login password, but a generated API password.

Base Endpoint

Flowmage automatically builds the base URL:

https://{host}/tas/api

Request Configuration

HTTP Method

Choose the type of request:

• GET → Retrieve data

• POST → Create data

• PATCH / PUT → Update data

• DELETE → Remove data

Example:

GET

Endpoint Path

The API endpoint you want to call.

Example:

/tas/api/incidents

? This is appended to your host.

Query Parameters (JSON)

Optional parameters added to the request URL.

Example:

{  "page_size": 10 }

? These become:

?page_size=10

Headers (JSON)

Optional headers for advanced requests.

Example:

{  "Accept": "application/json" }

How It Works

1. Flow reaches the TOPdesk node

2. Authentication is applied using your credentials

3. API request is sent to TOPdesk

4. Response is returned

5. Output becomes available for next steps

Output / Variables

The TOPdesk response is available using your Output ID.

Example:

@topdeskOutput.value@

? Example:

@topdeskOutput.value[0].number@

Example Use Cases

Get Incidents

Method: GET  Endpoint: /tas/api/incidents

Create Incident

Method: POST  Endpoint: /tas/api/incidents

Body example:

{  "briefDescription": "New incident from Flowmage",  "request": "Automatically created ticket" }

Update Incident

PATCH /tas/api/incidents/{id}

Sync Users

• Retrieve persons from TOPdesk

• Sync to another system

• Update changes automatically

Common Mistakes

❌ Wrong Endpoint Path

Using incorrect path.

✅ Always use /tas/api/...

❌ Using Wrong Credentials

Authentication fails.

✅ Use application password, not normal password

❌ Missing Headers

Some endpoints require headers.

✅ Add Accept: application/json when needed

❌ Incorrect JSON Format

Request fails.

✅ Validate JSON before sending

Pro Tips

• Use variables to dynamically build endpoints

• Combine with conditions for status handling

• Use logging for debugging API responses

• Keep requests small and efficient

• Test endpoints outside Flowmage first if unsure

Summary

The TOPdesk node allows you to automate IT service management workflows by interacting directly with the TOPdesk API.

With flexible configuration and full API access, you can build powerful integrations between support systems and your automation flows.

? Next step: Combine TOPdesk with triggers and AI nodes to automate ticket handling and support workflows.