Skip to main content
Question

Linking people to incidents

  • July 8, 2026
  • 5 replies
  • 58 views

Otavio Augusto Bosa
Forum|alt.badge.img+3

Hi everyone!

I’d like to know if anyone has used—or knows how to use—an automated method or API to link people to incidents.

An interesting detail arises when importing emails as incidents: if the "CC" field in the email is populated (i.e., people are listed in the "CC" line), TOPdesk reads this information during the import and automatically creates the link.

The link I am referring to here is not the "shared incidents" feature, but rather the link found in the OData `PersonIncidentLinks` table.

What is my goal in automating this?
With this information in `PersonIncidentLinks`, I can create an incident selection that checks the `PersonIncidentLinks` data to identify incidents shared with a specific person.

5 replies

Joost Oostindie
Forum|alt.badge.img+9

Hi Otavio,

I have looked through the documentation of different endpoints for incidents and persons a bunch of times, but can't find anything that gives you information about getting person links to incidents or patching person links to incidents or vice versa.

Your best bet is probably to see what exact information you get back when using the OData `PersonIncidentLinks` and to see if you even get anything else besides the caller (that would be seen as the linked person). I don't know if you get other links through this endpoint as well.

If it is indeed also offering information about linked persons to incidents in the link tab or shared incidents, the only way I know to provide those right now is by hand in the incident itself. The API offers no solution for this that I can find.


Otavio Augusto Bosa
Forum|alt.badge.img+3

Hi Joost!

My question is simply whether there is an API to establish the link, rather than doing it manually on the incident screen itself.


tverschuur
Forum|alt.badge.img+5
  • Explorer ⭐⭐⭐
  • July 11, 2026

Ik heb een actiereeks gebouwd die de personen ophaalt uit Melding > tabblad Koppelingen > tabblad Personen en deze vervolgens in "Gedeeld met" plaatst.
Omdat hier volgens mij vaker vragen over zijn gesteld in de community, zal ik hier volgende week een apart topic voor aanmaken. Daarin zal ik ook de bijbehorende JSON met jullie delen!


Otavio Augusto Bosa
Forum|alt.badge.img+3

Ik heb een actiereeks gebouwd die de personen ophaalt uit Melding > tabblad Koppelingen > tabblad Personen en deze vervolgens in "Gedeeld met" plaatst.
Omdat hier volgens mij vaker vragen over zijn gesteld in de community, zal ik hier volgende week een apart topic voor aanmaken. Daarin zal ik ook de bijbehorende JSON met jullie delen!

I need exactly the reverse of the process you described.

When a person is added via "Shared with...", I need to add that same person via the link: Incidents > Links tab > People tab.


tverschuur
Forum|alt.badge.img+5
  • Explorer ⭐⭐⭐
  • July 13, 2026

Helaas kan ik je niet helpen met de wens om, wanneer een persoon wordt toegevoegd via 'Gedeeld met...', deze automatisch ook toe te voegen onder Incidenten > Koppelingen > Personen.

Conclusie

Personen van Koppelingen > Personen naar Gedeeld met...: mogelijk en werkend.

Personen van Gedeeld met... naar Koppelingen > Personen: niet mogelijk via de beschikbare API's en werkt daarom niet.

De oorzaak is dat 'Gedeeld met...' via een publieke API kan worden bijgewerkt, terwijl PersonIncidentLinks alleen via de OData Reporting-feed kan worden uitgelezen en niet kan worden aangemaakt of aangepast. Daardoor is synchronisatie alleen in de eerste richting mogelijk