post https://api.oysterhr.com/v0.1/hiring/employments//submit
This API endpoint allows you to submit the employment record within your system when all required hiring information is collected. Below are all the required fields depending on the country you assign to the employment. You will receive a complete response with the updated record details.
To successfully submit an Employment, most fields are required based on the Employment's designated country. Missing fields can be updated later using the Update employment endpoint.
Fields | Required | Notes |
---|---|---|
seniority_level | Yes | |
role_type | Yes | This can be looked up using the Role Types endpoint |
role | Yes | The job title of the employee |
job_description | Yes | |
start_date | Yes | |
end_date | Yes | |
employment_type | Yes | This must be either FULL_TIME or PART_TIME |
working_hours | Yes | |
probation_period | Yes | |
salary | Yes | |
resignation_notice | Yes | Depending on the country of employment, this field might be required. |
termination_notice | Yes | Depending on the country of employment, this field might be required. |
remote_work_costs | Yes | |
vacation | Yes | |
sick_pay | Yes | Depending on the country of employment, this field might be required. |
default_signer | Yes |