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 slug of the specific legal entity that the employee will be engaged by and billed to as the engaged_by_entity_slug 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