Create Employee Mapping
Create a new employee mapping for a given organization.
A mapping is identified by the employee_id + system_integration_id pair. Creating is
idempotent for an identical mapping: posting one that already exists returns 200 with the
existing mapping and writes nothing, while a genuinely new mapping returns 201.
A create is never allowed to change an existing mapping. If a mapping for the pair already
exists but carries a different external_id or status, the request is rejected with 409
— use PUT /v1/org/employees/mappings/{employee_mapping_id} to change it.
Permissions required: Employee: Create, SystemIntegration: Get
Authorizations
Bearer token for authentication
Body
Employee Mapping Create Request
Request schema for creating an employee mapping
Creates an employee mapping. Once connected to an employee and system integration, the mapping can not be made to point to a different employee or system integration. Only the external_id and status can be updated, and only through PUT — re-posting an existing mapping with a different external_id or status is rejected with 409 rather than applied.
Response
Existing identical employee mapping, unchanged
An employee mapping
Describes the relationship between an employee and a system to which the employee belongs. Only included if requested by submitting relations=employee_mappings.