Creates an employment. We support creating employees and contractors.
Global Payroll Employees
To create a Global Payroll employee, pass global_payroll_employee as the type parameter,
and provide the id of the specific legal entity that the employee will be engaged by and billed to as the engaged_by_legal_entity_id parameter.
HRIS Employees
To create a HRIS employee, pass hris as the type parameter.
This endpoint requires and returns country-specific data. The exact required and returned fields will
vary depending on which country the employment is in. To see the list of parameters for each country,
see the Show form schema endpoint under the Countries category.
Please note that the compliance requirements for each country are subject to change according to local
laws. Given its continual updates, using Remote's json-schema-form should be considered in order to avoid
compliance issues and to have the latest version of a country requirements.
If you are using this endpoint to build an integration, make sure you are dynamically collecting or
displaying the latest parameters for each country by querying the "Show form schema" endpoint.
For more information on JSON Schemas, see the How JSON Schemas work documentation.
To learn how you can dynamically generate forms to display in your UI, see the documentation for
the json-schema-form tool.
Scopes
| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
Manage employments (employments) | - | Manage employments (employment:write) |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||