Skip to main content
POST
/
v1
/
org
/
employees
/
mappings
Create Employee Mapping
curl --request POST \
  --url https://api.twine.se/v1/org/employees/mappings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "employee_id": "<string>",
    "external_id": "<string>",
    "status": "active",
    "system_integration_id": "<string>"
  }
}
'
{
  "data": {
    "employee_id": "<string>",
    "external_id": "<string>",
    "id": "<string>",
    "inserted_at": "2023-11-07T05:31:56Z",
    "status": "active",
    "status_updated_at": "2023-11-07T05:31:56Z",
    "system_integration_id": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token for authentication

Body

application/json

Employee Mapping Create Request

Request schema for creating an employee mapping

​
data
EmployeeMappingCreate · object
required

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.

Response

Employee mapping Response

An employee mapping

​
data
EmployeeMapping · object
required

Describes the relationship between an employee and a system to which the employee belongs. Only included if requested by submitting relations=employee_mappings.