2.1 - Medewerker gegevens - Automatische medewerker import via API
Access to this feature is currently restricted to authorized API users only. If you feel you need access to this feature, please contact email@example.com
This is an optional feature. Are you interested in using this feature? Contact your Customer Success Manager and discuss options and pricing.
You can acces the endpoint for Go sites on the following host: https://sitenaam.api.go.springest.nl.
Note: Edit the sitename to the name that is applicable to your site. So, for example with site name examplecompany.go.springest.nl; the url to be used will be: examplecompany.api.go.springest.nl
In order to process a user you need to send a POST request (json) to the following endpoint.
We support both creating and updating existing users. Users will be matched on email address.
All data you send will override the existing data, even when a value is empty.
We support the following data fields:
|gender||string||no||"m" or "f"|
When you POST your data to our API we run some validations on our end and will only process the conversion when they pass. When they don't, we let you know. As such, there are a couple of possible responses:
- 201 Created When the user has been created successfully. It will return the ID of the user as a response. You can save this id as a reference to how we saved the booking.
- 400 Bad Request We were not able to process this user, the response will contain relevant validation errors.
Further details about specific fields
Background: read more about the "manager approval" feature here.
Possible situations to consider:
- Approver does not exist yet When adding approvers to a user, it's important that the approver has an existing, active user account. If you try to add an approver that does not exist, you will get validation errors.
Background: this field is only relevant when your organisation uses the "learning tracks" feature. Based on these tags, any learning tracks with matching tags will be assigned automatically to the user.
Instructions: this field should be an array of strings, separated by comma's. Special characters (including spaces) are allowed. Any uppercase letters will be downcased in our application.
["Marketer", "Netherlands", "department-1"]