TOPdesk Integration

IT service management and enterprise help desk software. Route TOPdesk tickets, replies, and customer issues into CRM, chat, and escalation workflows. When Watch Incidents arrives, automatically continue with Filter Assets or Get a Current Person.

Explore Documentation

3-day trialCancel anytimeUp to 10 minutes quick set up

GDPR
Data Encryption
2FA
Local Data Region

Supported triggers and actions for TOPdesk integration

Triggers can detect changes in TOPdesk and run actions that can create, search or modify data inside TOPdesk automatically [3] — exactly how you set them.

Watch IncidentsTriggers when a new incident occurs.
Watch LocationsTriggers when a new location event is observed.
Watch OperatorsTriggers when an operator performs a specific action or activity.
Watch PersonsTriggers when there is a new person detected.
Filter AssetsFilters assets based on specified criteria using a POST request.
Get a Current PersonGets the current person's information.
Get a Person CountRetrieves the total number of persons in a specified context.
Get a ServiceRetrieves a specific service based on the provided criteria.
Get a Service WindowRetrieves a service window based on specified criteria.
Get a Supplier by IDRetrieves a supplier using their unique ID.
Get a TOPdesk Product VersionRetrieves the version of a TOPdesk product.
Get an AssetRetrieves details of a specific asset by its ID.
Get an Email by IDRetrieves an email by its ID.
Get an Incident by IDRetrieves details of an incident using its ID.
Get an Incident by NumberRetrieves an incident by its unique number for detailed information.
Get an Operator by IDRetrieves an operator using their ID.
Get API VersionRetrieves the current version of the API in use.
Get Asset Current History ItemsRetrieves the current history items of an asset.
Get Asset Past History ItemsRetrieves past history items for a specified asset.
Get Current Operator IDGets the current operator's ID.
Get Linked Assets of ServiceRetrieves linked assets associated with a service.
Get Location by IDRetrieves a location using the specified ID.
Get Optional Searchlist ValuesRetrieves optional values from a search list.
Get Supplier by IDRetrieves a supplier's information using their ID.
List Archiving ReasonsRetrieves a list of archiving reasons.
List AssetsRetrieves a list of assets from the service.
List CategoriesRetrieves a list of all categories available in the service.
List IncidentsRetrieves a list of incidents.
List LocationsRetrieves data of multiple locations.
List OperatorsRetrieves a list of operators from the service.
List PersonsRetrieves a list of persons from the service.
List Service WindowsRetrieves a list of service windows from the system.
List ServicesRetrieves a list of services.
List SuppliersRetrieves a list of suppliers from the service.
List Time Spent ReasonsLists the reasons for time spent entries.
Lookup SuppliersSearches for suppliers based on specified criteria.
SearchSearches for the specified data.
Archive a LocationArchives a specific location from the system.
Archive a LocationArchives a location partially.
Archive an AssetArchives an asset by moving it to the archival storage.
Copy an AssetCopies an asset from a source location to a destination.
Create a Custom Task NotificationCreates a notification for a custom task.
Create a PersonCreates a person record in the system.
Create a ServiceCreates a new service entry in the system.
Create an AssetCreates an asset in the specified service.
Create an IncidentCreates an incident in the system.
Create an OperatorCreates a new operator in the system.
Create LocationCreates a new location within the system.
Delete an EmailDeletes an email from the user's mailbox.
Delete AssetsDeletes assets in bulk from the service.
Link Assets to a ServiceLinks assets to a specific service identified by the user.
Make an API CallMakes an arbitrary call to the API.
Unarchive a LocationRestores a previously archived location to its original state.
Unarchive a LocationUnarchives a specified location.
Unarchive an AssetUnarchives a specified asset, making it active and available again.
Unlink an Asset from a ServiceUnlinks an asset from a specific service.
Update a LocationUpdates the details of a location partially, allowing modifications to specific fields.
Update a PersonUpdates a person with new information in the system.
Update an AssetUpdates a specific asset with new information.
Update an Asset-Service LinkUpdates an asset-service link in the system.
Update an Incident by IDUpdates an incident using its ID with partial data provided.
Update an Incident by NumberUpdates an incident using its number, fully replacing the existing data with the new information provided.
Update an Incident by Number (Partial)Updates a specific incident record by its number, partially modifying the incident's details.
Update an Operator (Full Replace)Updates an operator by fully replacing the existing data with new data.
Update Incident by IDUpdates an incident using the given ID, performing a full replace of its details.
Update LocationUpdates a location with new information.
Update OperatorUpdates a specific operator partially with the provided details.

How to integrate TOPdesk in automation workflow?

3 simple steps to make your TOPdesk connected with other apps in automation workflows on WEXTL. Up to 10 minutes integration set up.

STEP 1

Select TOPdesk in workflow

Pick TOPdesk app in the workflow builder [4] - just one click to select the app.

STEP 2

Connect TOPdesk

When prompted, authorize access to TOPdesk in WEXTL once. TOPdesk credentials are encrypted and never shared with WEXTL. Authorization will be reused in any future API calls [3].

WEXTL wants to integrate with your TOPdesk account. Approve?

STEP 3

Build a workflow

Build your workflow with TOPdesk yourself or with WEXTL® AI Builder. Connect TOPdesk to any available integrations [5], or use HTTP node to go beyond them.

TOPdesk

How TOPdesk connects and integrates with WEXTL

Save and approve your credentials once — WEXTL® stores authorization information encrypted and reuses the authentication whenever TOPdesk app is called in workflows. That allows your support automations to run without your attention, per defined schedule [7]. Explore documentation [6] for a detailed list of fields that TOPdesk supports.

Full TOPdesk API documentation

The following table illustrates what fields TOPdesk integration require during authorization flow inside our workflow builder [4].

Demonstration of TOPdesk connection step inside WEXTL Workflow Builder [4].

Field	Type	Help
Environment URLRequired	url	Your environment URL, e.g. https://yourcompany.topdesk.net
Operator login nameRequired	text	The login name of the operator the API calls run as. The operator needs a permission group with the REST API permission and the Use application passwords permission (API Access block), plus API permissions for the modules you use (incidents, assets, locations, persons, operators, supporting files). This connection uses operator login. Connections created earlier with a person login do not work any more and must be recreated.
Application passwordRequired	password	An application password, not the operator's normal TOPdesk password. In TOPdesk open the operator's user menu (your name, top right) -> Operator settings -> Application passwords, create a new application password and paste it here.

Connect TOPdesk to popular apps on WEXTL

Enter a name of the other app you want to sync with TOPdesk below. Click on selected app to explore integration options with TOPdesk. If the app you search for is not available in WEXTL yet, you can use HTTP node [10] instead to integrate it directly.

Example automation with TOPdesk integration

Select Watch Locations trigger from TOPdesk - this will be a starting point in your automation. Whenever event happens in TOPdesk, workflow will start [7] from Watch Locations node.

Search for Archive a Location, connect it as the next step of integration sequence. You can use filters between Watch Locations and Archive a Location, so only important data pass from Watch Locations to the next step. WEXTL gives you full control over the process of TOPdesk automation. All parts of workflow are visible on the canvas [4].

TOPdesk on WEXTL has 67 modules for crafting support automations. Explore TOPdesk documentation for more.

Video slide demonstrates how Watch Locations and Archive a Location nodes are used in TOPdesk workflow.

Video slide demonstrates how Watch Locations and Archive a Location [6] nodes are used in TOPdesk workflow.

Frequently asked questions

Common questions about automating TOPdesk in your workflows.

TOPdesk has 4 triggers, including "Watch Incidents", "Watch Locations", and "Watch Operators", and more. Triggers are start points of the workflow, and automations may start from them.

Integration has 63 actions, including "Filter Assets", "Get a Current Person", and "Get a Person Count", and more. Refer to our TOPdesk Documentation for detailed inputs and outputs.

No. Most automations are built visually on the canvas by picking triggers, actions, and mapping fields. You can add custom JavaScript with Functions when advanced logic is needed — but our customers do that in rare cases [4].

Yes. Connections are authenticated per account, credentials are encrypted at rest, and you can enforce approvals and team-level access controls on any automation.

The TOPdesk integration on WEXTL runs directly on its vendor public API — every field name, authentication method, and rate limit is controlled by TOPdesk official API and covered in documentation [3]. WEXTL handles the request signing and pagination for you.

Absolutely. Where TOPdesk provides native webhooks, you can use instant triggers to eliminate polling delay. For custom webhooks, WEXTL offers Custom Webhook node, so you can start automation whenever TOPdesk or any other service sends event to webhook URL.

WEXTL is an AI-first visual canvas. The platform allows you to describe automation in plain text — and AI will wire nodes for TOPdesk inside the workflow builder [4]. You can also use built-in workflow nodes (AI Agent, Human in the Loop, Condition, Aggregate Results) in pair with TOPdesk modules to craft complex integration flows with branches, filtering, and conditional logic. There are absolutely no limits of what you can build.

References

List of sources used to gather information about the TOPdesk integration.

TOPdesk integration source code, module specs and credentials implementation.
Internal TOPdesk integration documentation, structured input and output parameters, scopes, and authentication methods.
Official TOPdesk vendor API documentation — used to verify field meanings, authentication flows, and anything our own specs don't fully capture.
WEXTL® Visual Workflow Builder, anonymized data from our technical support team.
WEXTL® Apps Library
WEXTL® TOPdesk App Documentation
WEXTL® Workflow Scheduler
WEXTL® HTTP node documentation

TOPdesk Integration

Supported triggers and actions for TOPdesk integration