Integration · Customer support

Connect Claude & ChatGPT to TOPdesk

Ask your AI which incidents are open for a caller, to log a new one or to hand an incident to another operator group. It can search and read incidents with their request and action trail, create and update incidents, register time, look up and create persons, and plan and update operational activities.

Connect TOPdesk free

Free plan, no credit card. Takes about a minute.

Try asking

“What is the status of incident I 2409 123?”
The AI reads the incident by number with caller, request, status, operator and dates.
“Which open incidents does [email protected] have?”
It searches incidents with a filter on the caller and lists them with status.
“Log an incident for [email protected]: her laptop will not start.”
It creates the incident with caller, brief description and request, and can set category, call type and priority from your lists.

What your AI can do

Incidents

Search incidents with FIQL filters, read them by ID or number with requests and actions, and create and update incidents.

Persons and operators

Search, create and update persons, and look up operators, operator groups and branches.

Planning and time

“Assign incident I 2409 123 to the network team and add a note.”
It looks up the operator group and updates the incident with the new group and an action text in the progress trail.
“Register 30 minutes on that incident.”
It registers the time spent on the incident, with optional notes.
“Plan the server patch as an operational activity next Tuesday.”
It creates an operational activity with a brief description, planned start and end dates and operator group.

273 tools for TOPdesk

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

archive_a_branchVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a branch.
archive_a_budget_holderVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a budget holder.
archive_a_departmentVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a department.
archive_a_locationVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a location.
archive_a_person_groupVisible to othersArchive a contact (persongroup id). Has effects visible outside this system. API summary: Archive a person group.
archive_an_operatorVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive an operator.
archive_an_operator_groupVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive an operator group.
archive_contactVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive an incident by id.
archive_contact_archiveVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a branch.
archive_contact_patch_archive_locationVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a location.
archive_contact_patch_archive_operatorVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive an operator.
archive_contact_patch_archive_operator_groupVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive an operator group.
archive_contact_patch_archive_personVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a person and its linked operator if there is one.
archive_contact_put_archive_personVisible to othersArchive a contact (id id). Has effects visible outside this system. API summary: Archive a person and its linked operator if there is one.
archive_numberVisible to othersArchive a number (number number). Has effects visible outside this system. API summary: Archive an incident by number.
attach_branchChanges dataAttach a branch (id id). API summary: Link branch filters to an operator.
attach_categoryChanges dataAttach a category (id id). API summary: Link category filters to an operator.
attach_operatorChanges dataAttach a operator (id id). API summary: Link operator filters to an operator.
attach_operatorgroup_to_contactChanges dataAttach a operatorgroup (id id). API summary: Link operator groups to an operator.
attach_permissiongroup_to_contactDeletesAttach a permissiongroup (id id). Destructive action; may require approval. API summary: Link permission groups to an operator.
create_a_person_extra_field_b_entryChanges dataCreate a new page. Required: name. API summary: Create a person extra field B entry.
create_addressChanges dataCreate a new address. Required: name or branch. Search addresses first to avoid duplicates. API summary: Create a location.
create_an_optional_person_drop_down_list_entryChanges dataUpdate an existing searchlist identified by searchlist. API summary: Create an optional person drop-down list entry.
create_branchChanges dataCreate a new branch. Required: name. Search branches first to avoid duplicates. API summary: Create a branch.
create_budgetholderChanges dataCreate a new budgetholder. Required: name. API summary: Create a budget holder.
create_contactChanges dataCreate a new contact. Required: name. Search contacts first to avoid duplicates. API summary: Create a person group.
create_contact_documentChanges dataCreate a new document for a contact. API summary: Upload a file to an incident identified by id.
create_contact_document_postChanges dataCreate a new document for a contact. API summary: Upload a file to an incident identified by id for a SSP user.
create_departmentChanges dataCreate a new department. Required: name. API summary: Create department.
create_incidentChanges dataCreate an incident. In `body` set caller (email or id), briefDescription, request, and optionally category, subcategory, callType, priority, operator/operatorGroup and an initial action.
create_incident_postChanges dataCreate a new incident. Search incidents first to avoid duplicates. API summary: Creates an Incident for a SSP user.
create_number_documentChanges dataCreate a new document for a number. API summary: Upload a file to an incident identified by number.
create_number_document_postChanges dataCreate a new document for a number. API summary: Upload a file to an incident identified by number for a SSP user.
create_number_timespentChanges dataCreate a new timespent for a number. Required: time spent. API summary: Register time spent on an incident by number.
create_operational_activityChanges dataCreate an operational activity with a brief description, planned start/end dates, type, category, operator or operator group.
create_operatorChanges dataCreate a new operator. Required: body. Search operators first to avoid duplicates. API summary: Create an operator.
create_operatorgroupChanges dataCreate a new operatorgroup. Required: group name or branch. Search operatorgroups first to avoid duplicates. API summary: Create an operator group.
create_pageChanges dataCreate a new page. Required: name. API summary: Create a person extra field A entry.
create_personChanges dataCreate a person. In `body` set surName, and optionally firstName, email, phoneNumber, jobTitle, branch (by id) and department.
create_task_actionChanges dataCreate a new action for a task. API summary: Creates a new action for an operational activity.
create_task_addressChanges dataCreate a new address for a task. Required: items. Search addresses first to avoid duplicates. API summary: Link locations to an operational activity.
create_task_linked_assetChanges dataCreate a new linked asset for a task. Required: items. API summary: Link assets to an operational activity.
create_task_linked_branchChanges dataCreate a new linked branch for a task. Required: items. API summary: Link branches to an operational activity.
create_task_time_registrationChanges dataCreate a new time registration for a task. API summary: Register time for operational activity.
delete_a_branch_attachmentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a branch attachment.
delete_a_departmentDeletesPermanently delete a contact by contact id. Destructive action; may require approval. API summary: Delete a department.
delete_branchesMoves moneyPermanently delete a branch by id id. Financial or irreversible action; may require approval. API summary: Unlink branch filters from an operator.
delete_categoriesMoves moneyPermanently delete a category by id id. Financial or irreversible action; may require approval. API summary: Unlink category filters from an operator.
delete_contactDeletesPermanently delete a contact by contact id. Destructive action; may require approval. API summary: Delete a budget holder.
delete_contact_actionDeletesPermanently delete a action by actionid. Destructive action; may require approval. API summary: Delete action by incident id and action id.
delete_contact_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a file from an incident identified by id.
delete_contact_requestDeletesPermanently delete a request by requestid. Destructive action; may require approval. API summary: Delete request by incident id and request id.
delete_email_by_idDeletesPermanently delete a contact by contact id. Destructive action; may require approval. API summary: delete email by id.
delete_number_actionDeletesPermanently delete a action by actionid. Destructive action; may require approval. API summary: Delete action by incident number and action id.
delete_number_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a file from an incident identified by number.
delete_number_requestDeletesPermanently delete a request by requestid. Destructive action; may require approval. API summary: Delete request by incident number and request id.
delete_operatorsMoves moneyPermanently delete a operator by id id. Financial or irreversible action; may require approval. API summary: Unlink operator filters from an operator.
detach_operatorgroup_to_contactMoves moneyDetach a operatorgroup (id id). Financial or irreversible action; may require approval. API summary: Unlink operator groups from an operator.
detach_permissiongroup_to_contactMoves moneyDetach a permissiongroup (id id). Financial or irreversible action; may require approval. API summary: Unlink permission groups from an operator.
download_an_attachmentDownload the document for a document. API summary: Download an attachment.
download_an_attachment_for_a_ssp_userDownload the document for a document. API summary: Download an attachment for a SSP user.
download_documentDownload the document for a document. API summary: Download an attachment.
download_document_downloadDownload the document for a document. API summary: Downloads the file attachment of the operational activity.
get_a_person_s_contractList contacts for a contact. API summary: Get a person's contract.
get_a_person_s_private_detailsList contacts for a contact. API summary: Get a person's private details.
get_an_operator_by_idGet one lookup by lookup id. API summary: Get an operator by id.
get_an_operator_group_by_idGet one lookup by lookup id. API summary: Get an operator group by id.
get_avatar_of_person_by_idGet one contact by contact id. API summary: Get avatar of person by id.
get_contact_2Get one contact by contact id. API summary: Get details of email by id for incidents, changes and change activites.
get_contact_actionGet one action for a contact by actionid. API summary: Get incident actions by incident id and action id.
get_contact_action_getGet one action for a contact by actionid. API summary: Get incident actions by incident id and action id for SSP users.
get_contact_countGet one contact. API summary: Get total number of persons for SSP user. Only counts persons that are marked as callers (requesters) and are active (not archived).
get_contact_getGet one contact by contact id. API summary: Returns an incident for a SSP user.
get_contact_get_person_by_id_for_requesterGet one contact by contact id. API summary: Get person by id for SSP user. Only returns the person when it is marked as a caller (requester) and is active (not archived).
get_contact_imageGet one image for a contact by file name. API summary: Retrieve an image from an incident identified by id.
get_contact_image_getGet one image for a contact by file name. API summary: Retrieve an image from an incident identified by id for a SSP user.
get_contact_requestGet one request for a contact by requestid. API summary: Get incident request by incident id and request id.
get_contact_request_getGet one request for a contact by requestid. API summary: Get incident request by incident id and request id for SSP users.
get_current_operatorGet the operator account the connection is logged in as.
get_details_of_branch_by_idGet one contact by contact id. API summary: Get details of branch by id.
get_details_of_location_by_idGet one contact by contact id. API summary: Get details of location by id.
get_details_of_supplier_contact_by_idGet one contact by contact id. API summary: Get details of supplier contact by id.
get_free_field_searchlistGet one searchlist for a free field by searchlist. API summary: Get list of optional drop-down values.
get_incidentGet one incident by its ID (`contact_id` is the incident UUID), with caller, request, status, operator and dates.
get_incident_by_numberGet one incident by its incident number (e.g. "I 2409 123").
get_list_of_branch_filtersSearch branches. Use this to find existing branches before creating a new branch. API summary: Get list of branch filters.
get_list_of_branches_for_ssp_userSearch branches by query. Use this to find existing branches before creating a new branch. Results are paginated. API summary: Get list of branches for SSP user.
get_list_of_call_types_for_ssp_usersList call types. API summary: Get list of call types for SSP users.
get_list_of_categoriesList categories. API summary: Get list of categories.
get_list_of_locations_for_ssp_userSearch addresses by query or fields. Use this to find existing addresses before creating a new address. Results are paginated. API summary: Get list of locations for SSP user.
get_list_of_operator_filtersSearch operators. Use this to find existing operators before creating a new operator. API summary: Get list of operator filters.
get_list_of_optional_drop_down_values_for_branchesGet one searchlist for a free field by searchlist. API summary: Get list of optional drop-down values for branches.
get_list_of_optional_drop_down_values_for_locationsGet one searchlist for a free field by searchlist. API summary: Get list of optional drop-down values for locations.
get_list_of_optional_drop_down_values_for_operatorsGet one searchlist for a free field by searchlist. API summary: Get list of optional drop-down values for operators.
get_list_of_optional_drop_down_values_for_personsGet one searchlist for a free field by searchlist. API summary: Get list of optional drop-down values for persons.
get_list_of_room_statusesList statuses. API summary: Get list of room statuses.
get_list_of_subcategoriesList subcategories. API summary: Get list of subcategories.
get_list_of_supplier_contactsSearch contacts by query. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Get list of supplier contacts.
get_logged_in_personList contacts. API summary: Get logged in person.
get_lookupGet one lookup by lookup id. API summary: Get a caller by id.
get_lookup_get_branch_lookup_entryGet one lookup by lookup id. API summary: Returns a branch id, name pair.
get_lookup_get_location_lookup_entryGet one lookup by lookup id. API summary: Returns a location id, name pair.
get_lookup_get_operator_group_lookup_entryGet one lookup by lookup id. API summary: Returns an operator group id, name pair.
get_lookup_get_operator_lookup_entryGet one lookup by lookup id. API summary: Returns an operator id, name pair.
get_lookup_get_person_group_lookup_entryGet one lookup by lookup id. API summary: Returns a person group id, name pair.
get_lookup_get_person_lookup_entryGet one lookup by lookup id. API summary: Returns a person id, name pair.
get_lookup_get_supplier_lookup_entryGet one lookup by lookup id. API summary: Returns a supplier id, name pair.
get_number_actionGet one action for a number by actionid. API summary: Get incident actions by incident number and action id.
get_number_action_getGet one action for a number by actionid. API summary: Get incident actions by incident number and action id for SSP users.
get_number_getGet one number by number number. API summary: Returns an incident for a SSP user.
get_number_imageGet one image for a number by file name. API summary: Retrieve an image from an incident identified by incident number.
get_number_image_getGet one image for a number by file name. API summary: Retrieve an image from an incident identified by incident number for a SSP user.
get_number_requestGet one request for a number by requestid. API summary: Get incident request by incident number and request id.
get_number_request_getGet one request for a number by requestid. API summary: Get incident request by incident number and request id for SSP users.
get_operational_activityGet one operational activity by `task_identifier` (ID or number).
get_operational_seriesGet one operational series by operational series identifier. API summary: Get operational series by id.
get_operatorGet one operator by operator id. API summary: Get avatar of operator by id.
get_operator_by_idGet one contact by contact id. API summary: Get operator by id.
get_operator_get_operator_avatar_for_requesterGet one operator by operator id. API summary: Get avatar of operator by id for SSP user.
get_operator_group_by_idGet one contact by contact id. API summary: Get operator group by id.
get_personGet one person by ID (`contact_id` is the person UUID).
get_person_group_by_id_v2Get one contact by contact id. API summary: Get person group by id (v2).
get_pictureGet one picture by picture id. Results are paginated. API summary: Get a Picture as bytestream.
get_progresstrailGet one progresstrail by id id. API summary: Get incident progress trail entry count by incident id.
get_progresstrail_2Get one progresstrail by number number. API summary: Get incident progress trail entry count by incident number for SSP users.
get_progresstrail_countGet one progresstrail by number number. API summary: Get incident progress trail entry count by incident number.
get_progresstrail_getGet one progresstrail by id id. API summary: Get incident progress trail entry count by incident id for SSP users.
get_service_windowGet one lookup by lookup id. API summary: Get service window.
get_settings_for_operational_activitiesList settings. API summary: Get settings for operational activities.
get_supplierGet one supplier by supplier id. API summary: Get details of supplier by id.
get_task_messageGet one message for a task by message id. API summary: Retrieves an email of an operational activity by id.
get_the_branch_filters_of_an_operatorSearch branches. Use this to find existing branches before creating a new branch. API summary: Get the branch filters of an operator.
get_the_category_filters_of_an_operatorSearch categories. Use this to find existing categories before creating a new category. API summary: Get the category filters of an operator.
get_the_id_of_the_current_operatorList contacts. API summary: Get the id of the current operator.
get_the_list_of_attachments_of_a_branchList documents for a contact. API summary: Get the list of attachments of a branch.
get_the_operator_filters_of_an_operatorSearch operators. Use this to find existing operators before creating a new operator. API summary: Get the operator filters of an operator.
get_timeregistrationGet one timeregistration by timeregistration id. API summary: Returns an timeregistration by id.
get_total_number_of_personsGet one contact. API summary: Get total number of persons.
list_archiving_reasonsList archiving reasons. API summary: Get list of reasons for archiving.
list_budgetholdersList budgetholders. Optional filters: external link id or external link type. API summary: Get list of budgetholders.
list_building_levelsList building levels. API summary: Get list of building levels.
list_building_zonesList building zones. API summary: Get list of building zones.
list_call_typesList incident call types (e.g. question, complaint, disruption).
list_categoriesList incident categories.
list_ceiling_coveringsList ceiling coverings. API summary: Get list of ceiling coverings.
list_closure_codesList closure codes. API summary: Get list of closure codes.
list_contact_actions_getList actions for a contact. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident actions by incident id for SSP users.
list_contact_avatarsList avatars for a contact. API summary: Get a person's avatar.
list_contact_documentsList documents for a contact. Optional filters: non api attachment urls. Results are paginated. API summary: Get incident attachments by incident id.
list_contact_documents_getList documents for a contact. Optional filters: non api attachment urls. Results are paginated. API summary: Get incident attachments by incident id for a SSP user.
list_contact_imagesList images for a contact. API summary: Get a list of images for an incident identified by id.
list_contact_images_getList images for a contact. API summary: Get a list of images for an incident identified by id for a SSP user.
list_contact_operatorsList operators for a contact. API summary: Get the operators of an operator group.
list_contact_permissiongroupsList permissiongroups for a contact. API summary: Get the permission groups of an operator.
list_contact_progresstrailsList progresstrails for a contact. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident progress trail by incident id.
list_contact_progresstrails_getList progresstrails for a contact. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident progress trail by incident id for SSP users.
list_contact_requests_getList requests for a contact. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident requests by incident id for SSP users.
list_contact_timespentsList timespents for a contact. API summary: Register time spent on an incident by id.
list_contacts_getList contacts. API summary: Login - as a person.
list_countriesList countries. API summary: Get list of countries.
list_deescalation_reasonsList deescalation reasons. API summary: Get list of reasons for deescalation.
list_departmentsList departments. Optional filters: external link id or external link type. API summary: Get list of departments.
list_designationsList designations. API summary: Get list of branch designations.
list_durationsList durations. API summary: Get list of durations.
list_energy_performancesList energy performances. API summary: Get list of energy performances.
list_entry_typesList entry types. API summary: Get list of entry types.
list_environmental_impactsList environmental impacts. API summary: Get list of environmental impacts.
list_escalation_reasonsList escalation reasons. API summary: Get list of reasons for escalation.
list_floor_coveringsList floor coverings. API summary: Get list of floor coverings.
list_functional_usesList functional uses. API summary: Get list of functional uses.
list_glass_materialsList glass materials. API summary: Get list of glass materials.
list_impactsList impacts. API summary: Get list of impacts.
list_incident_actionsList the actions (progress trail entries) of an incident by `id_id` (incident UUID).
list_incident_requestsList the request texts of an incident by `id_id` (incident UUID).
list_languagesList languages. API summary: Get list of languages.
list_number_actionsList actions for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident actions by incident number.
list_number_actions_getList actions for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident actions by incident number for SSP users.
list_number_documentsList documents for a number. Optional filters: non api attachment urls. Results are paginated. API summary: Get incident attachments by incident number.
list_number_documents_getList documents for a number. Optional filters: non api attachment urls. Results are paginated. API summary: Get incident attachments by incident number for a SSP user.
list_number_imagesList images for a number. API summary: Get a list of images for an incident identified by number.
list_number_images_getList images for a number. API summary: Get a list of images for an incident identified by number for a SSP user.
list_number_progresstrailsList progresstrails for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident progress trail by incident number.
list_number_progresstrails_getList progresstrails for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident progress trail by incident number for SSP users.
list_number_requestsList requests for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident requests by incident number.
list_number_requests_getList requests for a number. Optional filters: inlineimages, force images as data or non api attachment urls. Results are paginated. API summary: Get incident requests by incident number for SSP users.
list_number_timespentsList timespents for a number. API summary: Retrieve time spent on an incident by number.
list_operator_groupsList operator groups, optionally filtered with a FIQL `query`.
list_operatorsList operators, optionally filtered with a FIQL `query`, to find an operator ID for assigning incidents.
list_operators_2List operators. API summary: Login - (Deprecated) Log in as an operator.
list_pagesList pages. Optional filters: external link id or external link type. API summary: Get the list of non-archived person extra field A entries.
list_pages_get_person_extra_field_b_entriesList pages. Optional filters: external link id or external link type. API summary: Get the list of non-archived person extra field B entries.
list_permissiongroupsList permissiongroups. API summary: Get list of permission groups.
list_prioritiesList incident priorities.
list_processing_statusesList incident processing statuses.
list_product_versionsList product versions. API summary: Get TOPdesk version.
list_propertiesList properties. API summary: Get list of listed buildings.
list_reasons_for_anomaliesList reasons for anomalies. API summary: Lists non-archived reasons for anomaly for activites.
list_reasons_for_skippingsList reasons for skippings. API summary: Lists non-archived reasons for skipping for activites.
list_servicesList services. API summary: Get list of services.
list_settingsList settings. API summary: Get logged in operator's settings.
list_slasList slas. Optional filters: incident, contract, person, service, branch or budget holder. Results are paginated. API summary: Get list of SLA services.
list_statuses_getList statuses. API summary: Lists non-archived statuses for activites.
list_subcategoriesList incident subcategories and the category each belongs to.
list_task_actionsList actions for a task. API summary: Retrieves the list of actions of an operational activity.
list_task_documentsList documents for a task. API summary: Retrieves the list of attachments of an operational activity.
list_task_linked_objectsList linked objects for a task. API summary: Retrieves the list of linked objects of an operational activity.
list_task_messagesList messages for a task. API summary: Retrieves the list of emails of an operational activity.
list_task_requestsList requests for a task. API summary: Retrieves the list of requests of an operational activity.
list_task_time_registrationsList time registrations for a task. API summary: Retrieves the list of time registrations of an operational activity.
list_timespent_reasonsList timespent reasons. API summary: Get list of reasons for time spent.
list_typesList types. API summary: Get list of location types.
list_urgenciesList urgencies. API summary: Get list of urgencies.
list_wall_coveringsList wall coverings. API summary: Get list of wall coverings.
log_incident_timeChanges dataRegister time spent on an incident (`id_id` is the incident UUID): `time_spent` in minutes, with optional notes, operator and reason.
restore_contactChanges dataUnarchive a contact (id id). API summary: Unarchive an incident by id.
restore_contact_patch_unarchive_branchChanges dataUnarchive a contact (id id). API summary: Unarchive a branch.
restore_contact_patch_unarchive_locationChanges dataUnarchive a contact (id id). API summary: Unarchive a location.
restore_contact_patch_unarchive_operatorChanges dataUnarchive a contact (id id). API summary: Unarchive an operator and its linked person if there is one.
restore_contact_patch_unarchive_operator_groupChanges dataUnarchive a contact (id id). API summary: Unarchive an operator group.
restore_contact_patch_unarchive_personChanges dataUnarchive a contact (id id). API summary: Unarchive a person.
restore_contact_post_unarchive_person_groupChanges dataUnarchive a contact (id id). API summary: Unarchive a person group.
restore_contact_put_unarchive_locationChanges dataUnarchive a contact (id id). API summary: Unarchive a location.
restore_contact_put_unarchive_operatorChanges dataUnarchive a contact (id id). API summary: Unarchive an operator and its linked person if there is one.
restore_contact_put_unarchive_operator_groupChanges dataUnarchive a contact (id id). API summary: Unarchive an operator group.
restore_contact_put_unarchive_personChanges dataUnarchive a contact (id id). API summary: Unarchive a person.
restore_contact_unarchiveChanges dataUnarchive a contact (id id). API summary: Unarchive a branch.
restore_contact_unarchive_budget_holderChanges dataUnarchive a contact (id id). API summary: Unarchive a budget holder.
restore_contact_unarchive_departmentChanges dataUnarchive a contact (id id). API summary: Unarchive a department.
restore_numberChanges dataUnarchive a number (number number). API summary: Unarchive an incident by number.
search_addressesSearch addresses by query or fields. Use this to find existing addresses before creating a new address. Results are paginated. API summary: Get list of locations.
search_addresses_lookupSearch addresses by name, archived or all. Use this to find existing addresses before creating a new address. Results are paginated. API summary: Returns location id, name pairs.
search_branchesSearch branches (sites), optionally with a FIQL `query`; needed for creating persons and incidents.
search_branches_lookupSearch branches by name, archived or all. Use this to find existing branches before creating a new branch. Results are paginated. API summary: Returns branch id, name pairs.
search_callersSearch callers by name, archived, all or page start. Use this to find existing callers before creating a new caller. Results are paginated. API summary: Get list of callers.
search_categoriesSearch categories. Use this to find existing categories before creating a new category. API summary: Get list of category filters.
search_categories_2Search categories by query or sort. Use this to find existing categories before creating a new category. API summary: Lists categories and subcategories for SSP user.
search_categories_getSearch categories by query or sort. Use this to find existing categories before creating a new category. API summary: Lists categories and subcategories.
search_contact_operatorgroupsSearch operatorgroups for a contact by query. Use this to find existing operatorgroups before creating a new operatorgroup. API summary: Get the operator groups of an operator.
search_contactsSearch contacts by page start, sort or query. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Get list of person groups (v2).
search_contacts_get_person_groups_of_person_by_idSearch contacts for a contact by page start, sort or query. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Get list of person groups of a person by id (v2).
search_contacts_get_person_lookup_listSearch contacts by name, archived, is caller or all. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Returns person id, name pairs.
search_contacts_get_personsof_persongroup_by_idSearch contacts for a contact by page start, sort or query. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Get list of persons of a persongroup by id (v2).
search_contacts_lookupSearch contacts by name, archived or all. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Returns person group id, name pairs.
search_contacts_retrieve_persons_for_requesterSearch contacts by page start, sort or query. Use this to find existing contacts before creating a new contact. Results are paginated. API summary: Get list of persons for SSP user. Only returns persons that are marked as callers (requesters) and are active (not archived).
search_groupingsSearch groupings by query or sort. Use this to find existing groupings before creating a new grouping. API summary: Get list of groupings for operational activities.
search_incidentsSearch incidents with a FIQL `query` (e.g. status==firstLine;caller.dynamicName=="Jane*"), with `sort`, `page_start` and `limit`. Use this to find incident IDs.
search_incidents_getSearch incidents by page start, sort, query, date format or all. Use this to find existing incidents before creating a new incident. Results are paginated. API summary: Returns a list of incidents for SSP users.
search_operational_activitiesSearch operational activities (planned tasks) with a FIQL `query`, sort and paging.
search_operatorgroupsSearch operatorgroups by name, archived, all, page start or role. Use this to find existing operatorgroups before creating a new operatorgroup. Results are paginated. API summary: Get list of operator groups.
search_operatorgroups_lookupSearch operatorgroups by name, archived, all, role or operatorid. Use this to find existing operatorgroups before creating a new operatorgroup. Results are paginated. API summary: Returns operator group id, name pairs.
search_operatorsSearch operators by name, archived, all or page start. Use this to find existing operators before creating a new operator. Results are paginated. API summary: Get list of operators.
search_operators_lookupSearch operators by name, archived, all, role, operatorgroupid or include service principals. Use this to find existing operators before creating a new operator. Results are paginated. API summary: Returns operator id, name pairs.
search_personsSearch persons (callers) with a FIQL `query` such as email=="[email protected]", with sort and paging.
search_schemasSearch schemas by query or sort. Use this to find existing schemas before creating a new schema. API summary: Get list of schemas for operational activities.
search_searchesSearch searches by query, index or start. Use this to find existing searches before creating a new search. API summary: Search via the REST-API.
search_service_windowsSearch service windows by name or archived. Use this to find existing service windows before creating a new service window. Results are paginated. API summary: Get list of service windows.
search_suppliersSearch suppliers by query. Use this to find existing suppliers before creating a new supplier. Results are paginated. API summary: Get list of suppliers.
search_suppliers_lookupSearch suppliers by name, archived or all. Use this to find existing suppliers before creating a new supplier. Results are paginated. API summary: Returns supplier id, name pairs.
search_timeregistrationsSearch timeregistrations by page start, sort or query. Use this to find existing timeregistrations before creating a new timeregistration. Results are paginated. API summary: Get list of time registrations. By default only time registrations entries for 1st and 2nd line incidents are returned.
search_typesSearch types by query. Use this to find existing types before creating a new type. API summary: Get list of types for operational activities.
update_a_person_group_by_idChanges dataUpdate an existing contact identified by contact id. Only the fields you pass are changed. API summary: Update a person group by id.
update_a_person_s_private_detailsVisible to othersUpdate an existing contact identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update a person's private details.
update_contact_deescalatesVisible to othersUpdate an existing deescalate identified by id id. Has effects visible outside this system. API summary: Deescalate an incident by id.
update_contact_escalatesVisible to othersUpdate an existing escalate identified by id id. Has effects visible outside this system. API summary: Escalate an incident by id.
update_contactsVisible to othersUpdate an existing contact identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update a person's contract.
update_free_field_searchlistChanges dataUpdate an existing searchlist identified by searchlist. API summary: Create an optional operator drop-down list entry.
update_incidentChanges dataUpdate an incident by ID (`contact_id` is the incident UUID). In `body` set fields such as status, operator, priority, category, closed/completed, or add an `action` text to the progress trail.
update_numberChanges dataUpdate an existing number identified by number number. Only the fields you pass are changed. API summary: Updates an Incident.
update_number_deescalatesVisible to othersUpdate an existing deescalate identified by number number. Has effects visible outside this system. API summary: Deescalate an incident by number.
update_number_escalatesVisible to othersUpdate an existing escalate identified by number number. Has effects visible outside this system. API summary: Escalate an incident by number.
update_operational_activityChanges dataUpdate an operational activity by `task_identifier`: status, dates, operator, resolved/skipped and other fields.
update_personChanges dataUpdate a person by ID (`contact_id`). In `body` pass only the fields to change.
update_task_requestChanges dataUpdate an existing request identified by request id. API summary: Updates an existing request of an operational activity.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose TOPdesk from the app list.
2
Paste your key
Enter your TOPdesk address without https:// (for example acme.topdesk.net), an operator login name and an application token. In TOPdesk open the Operator menu (top right) > My Settings and choose Add in the Application tokens block, name it, press Create and copy the token. It is shown only once. The operator needs API permissions.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in TOPdesk?

The AI can search and read incidents, their requests and actions, persons, operators, operator groups, branches and operational activities, plus lists of categories, call types, priorities and statuses. It can create and update incidents, persons and operational activities, and register time on incidents.

Does the AI see my TOPdesk application token?

No. Your TOPdesk credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Creating or changing incidents and persons can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own TOPdesk account.

Whose account does the AI work as?

The AI works as the operator whose login name and application token you enter, and it can do what that operator is allowed to do. The operator needs API permissions in TOPdesk. You can ask the AI to show which operator it is logged in as.