https://github.com/tools4everbv/helloid-task-sa-target-topdesk-changecreate
TOPdesk - Change create
https://github.com/tools4everbv/helloid-task-sa-target-topdesk-changecreate
delegated-form powershell product service-automation task topdesk
Last synced: 17 days ago
JSON representation
TOPdesk - Change create
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-task-sa-target-topdesk-changecreate
- Owner: Tools4everBV
- Created: 2023-12-08T20:24:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-17T13:46:53.000Z (8 months ago)
- Last Synced: 2025-11-17T15:22:48.809Z (8 months ago)
- Topics: delegated-form, powershell, product, service-automation, task, topdesk
- Language: PowerShell
- Homepage:
- Size: 42 KB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HelloID-Task-SA-Target-TOPdesk-ChangeCreate
## Prerequisites
- [ ] TOPdesk API Username and Key
- [ ] User-defined variables: `topdeskBaseUrl`, `topdeskApiUsername` and `topdeskApiSecret` created in your HelloID portal.
## Description
This code snippet will create an change within TOPdesk and executes the following tasks:
1. Define a hash table `$formObject`. The keys of the hash table represent the properties necessary to create an change within `TOPdesk`, while the values represent the values entered in the form.
> To view an example of the form output, please refer to the JSON code pasted below.
```json
{
"requester": {
"id": "40dd8b13-c8d2-4376-b21e-38ba6439ca38"
},
"briefDescription": "Change example",
"request": "This an example of an change",
"action": "Please act on this change example accordingly",
"changeType": "extensive",
"template": {
"id": "6ea334d2-ed23-4dc7-aacb-406d5d45b015"
},
"category": "Hardware",
"subcategory": "Smartphone",
"externalNumber": "12345678",
"impact": "Person",
"benefit": "Better user experience",
"priority": "P2"
}
```
> :exclamation: It is important to note that the names of your form fields might differ. Ensure that the `$formObject` hash table is appropriately adjusted to match your form fields.
> [See the TOPdesk API Docs page](https://developers.topdesk.com/explorer/?page=change#/Working%20as%20an%20operator/post_operatorChanges)
2. Creates authorization headers using the provided API key and secret.
3. Create an change using the: `Invoke-RestMethod` cmdlet. The hash table called: `$formObject` is passed to the body of the: `Invoke-RestMethod` cmdlet as a JSON object.