Skip to main content
You can create new Employees by sending a POST request with the corresponding request body to the /employees endpoint. The only required fields are as follows:
  • External_id in the request body: corresponds with the unique ID in your system
  • Language query parameter: language of the input data, which has an impact on the Skill extraction
  • Strict query parameter: by setting this to false, you can add Employees without Skill information. This is necessary for this tutorial since the Skill information will only follow in the subsequent steps.

​
Restoring Soft-Deleted Employees

If grace periods are enabled for your tenant, Employees are soft-deleted rather than permanently removed for the specified period. They are permanently deleted once the grace period expires. To restore a soft-deleted Employee, include the restore=true query parameter along with the Employee’s external_id in the request body. You can also update the Employee’s data during restoration by including additional fields in the request body.

​
Example

Submit a POST call to /employees?strict=false&language=auto with the following body: 
{
  "external_id": "101"
}