Persoon toevoegen aan persoonsgroup via API

Hi ​@Jerdi-Deltion,

Helaas is er op dit moment geen API endpoint aanwezig die ervoor kan zorgen dat je personen aan een persoonsgroep kan toevoegen.

De enige workarround die ik kan bedenken; een attribute op de persoonskaart vullen via de PATCH /persons/:id endpoint.

Vervolgens maak je een selectie die alle personen ophaalt die aan de voorwaarden voldoet.

Aan de persoonsgroep koppel je de gemaakte selectie. Vervolgens worden de personen automatisch toegevoegd. Dit gebeurd 1x per dag, in de nacht dacht ik.

Verre van ideaal. Mijn advies: maak een feature request hiervoor aan via het TIP platform: https://tip.topdesk.com.

Hi

Ik heb even gekeken in de oude whatsapp community maar kan hier niets op vinden. Overigens is er (nog) geen API koppeling mogelijk  voor het toevoegen van een persoonsgroep. Hopelijk komt het ooit! 

Hopelijk heb ik je goed geinformeerd zo! Alvast een fijn weekend. 

Zonde eigenlijk hè? Heel lastig is dit niet om te implementeren. Hopelijk kan iemand van TOPdesk hier eens op reageren. Het is een best veel gestelde vraag. Ik denk dat als een ontwikkelaar zich een dagje boos maakt, dit zo gerealiseerd is.

en niet alleen hiervoor, denk dat er genoeg plekken zijn in TOPdesk die (nog) geen api mogelijkheden bieden. 

Zoals ik vaker heb gezegd; ze zouden eens een What the Heck maand moeten introduceren. Waarbij er kleine features gereleased worden, waarbij je denkt ‘What the heck, waarom bestaat dit nog niet’? En dan voornamelijk features waarbij je klanten enorm kan helpen met iets kleins. Zoals dit topic…

Iets zoals Home Assistant; https://www.home-assistant.io/blog/2024/11/30/the-month-of-what-the-heck/

Ik ben het eens, eigenlijk is het al een what the heck dat ze dit nog niet hebben!

Je kunt wel via de personen/persoonsgroepenimport personen aan persoonsgroepen toevoegen.

Dat zou je kunnen “automatiseren” door de import te laten starten als er een nieuwe file wordt aangeboden.

Daar zitten wel wat haken en ogen aan op dit moment… Zo werkt een intiele import wel maar werkt een update volgens mij niet en een delete kan alleen de eerste 100 of 1000 personen aan een groep toevoegen/verwijderen. Dus ik liep een beetje vast daarmee.

Ik denk dat mijn collega de bug op heeft gelogd bij TOPdesk, want ik kon het ticketnummer niet terugvinden in mijn lijst met tickets anders had ik het nummer hier even gepost, zodat je er naar kon verwijzen.

Met wat reverse engineering (logbestanden), kon ik achterhalen welke endpoint men op de achtergrond gebruikt, tijdens het importeren.

[2026-01-19 16:52:59,869] INFO    131|__svc_importToApiImportServicePrincipal_|        /3489#API    Requested [trace: 3f28d628bd0fd9d7; span: 70afb866b6f02349] /tas/api/import/personGroups/fcb57c6c-9a8a-4b27-ac60-bce354ed6b06/persons (PUT)        | nl.ogdsoftware.tas.webserver.auth.ApiAuthenticationFilter

Vervolgens wat gespeeld met de body, met het resultaat dat ik een werkende oplossing gevonden hebt voor je. Hieronder de documentatie, maar let op: unsupported!!

Let op!
Onderstaande API endpoint verwijderd / ontkoppeld personen, die niet opgegeven zijn in de request body.

Haal dus eerst de huidige gekoppelde personen op middels /tas/api/persongroups/{id}/persons.

Persoon toevoegen aan persoonsgroep

Voegt personen toe aan een bestaande personGroup

Endpoint
https://customer.topdesk.net/tas/api/import/personGroups/{groupId}/persons

Path Parameters

Header

Request Body
Content-Type: application/json
Schema:

{
  "ids": [
    "person_unid",
    "person_unid"
  ]
}

Response

{
    "modified": true,
    "linkErrors": [],
    "unlinkErrors": []
}

Persoonsgroepen koppelen aan persoon

Voegt een bestaande persoon toe aan één of meerdere personGroups.

Endpoint
https://customer.topdesk.net/tas/api/import/persons/{personId}/persongroups

Path Parameters

Headers

Request Body
Content-Type: application/json
Schema:

{
  "ids": [
    "persongroup_unid",
    "persongroup_unid"
  ]
}

Response

{
    "modified": true,
    "linkErrors": [],
    "unlinkErrors": []
}

{
  "ids": [
    "person_unid",
    "person_unid"
  ]
}

{
    "modified": true,
    "linkErrors": [],
    "unlinkErrors": []
}

{
  "ids": [
    "persongroup_unid",
    "persongroup_unid"
  ]
}

{
    "modified": true,
    "linkErrors": [],
    "unlinkErrors": []
}

Dit zou werkzaam moeten zijn maar alle jeetjes nog aan toe… Dit is nou niet bepaald zo simpel als een documented API gebruiken in een action sequence….maarja daar waren we het al over eens haha