PeopleForce
Employees

Deprecated

Company API v1 is deprecated and will be removed in a future release. Migrate to a newer version — v4 is the latest. Use the version switcher in the header.

Create an employee position

POST
/api/public/v1/employees/{employee_id}/positions

Path Parameters

employee_id*integer

Request Body

application/x-www-form-urlencoded

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/public/v1/employees/0/positions" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'position_id=string&effective_from=string'
{  "data": {    "id": 0,    "effective_on": "string",    "position": {      "id": 0,      "name": "string",      "created_at": "string",      "updated_at": "string"    },    "location": {      "id": 0,      "name": "string",      "address": null,      "time_zone": "string",      "holiday_policy_id": null,      "created_at": "string",      "updated_at": "string"    },    "division": {      "id": 0,      "name": "string",      "created_at": "string",      "updated_at": "string"    },    "department": {      "id": 0,      "name": "string",      "parent_id": null,      "manager_id": null,      "department_level": null,      "fields": {},      "created_at": "string",      "updated_at": "string"    },    "job_level": null,    "reporting_to": {      "id": 0,      "first_name": "string",      "last_name": "string",      "email": "string"    },    "legal_entity": null,    "fields": {      "78": {        "name": "string",        "value": "string"      },      "79": {        "name": "string",        "value": "string"      },      "80": {        "name": "string",        "value": "string"      },      "81": {        "name": "string",        "value": "string"      },      "82": {        "name": "string",        "value": "string"      },      "83": {        "name": "string",        "value": "string"      },      "84": {        "name": "string",        "value": "string"      },      "86": {        "name": "string",        "value": "string"      },      "87": {        "name": "string",        "value": "string"      },      "89": {        "name": "string",        "value": "string"      },      "90": {        "name": "string",        "value": "string"      },      "92": {        "name": "string",        "value": "string"      },      "136": {        "name": "string",        "value": "string"      },      "137": {        "name": "string",        "value": "string"      },      "138": {        "name": "string",        "value": "string"      },      "139": {        "name": "string",        "value": "string"      },      "140": {        "name": "string",        "value": "string"      },      "141": {        "name": "string",        "value": "string"      },      "142": {        "name": "string",        "value": "string"      },      "144": {        "name": "string",        "value": "string"      },      "145": {        "name": "string",        "value": "string"      },      "147": {        "name": "string",        "value": "string"      },      "148": {        "name": "string",        "value": "string"      },      "150": {        "name": "string",        "value": "string"      },      "236": {        "name": "string",        "value": "string"      },      "237": {        "name": "string",        "value": "string"      },      "238": {        "name": "string",        "value": "string"      },      "239": {        "name": "string",        "value": "string"      },      "240": {        "name": "string",        "value": "string"      },      "241": {        "name": "string",        "value": "string"      },      "242": {        "name": "string",        "value": "string"      },      "244": {        "name": "string",        "value": "string"      },      "245": {        "name": "string",        "value": "string"      },      "247": {        "name": "string",        "value": "string"      },      "248": {        "name": "string",        "value": "string"      },      "250": {        "name": "string",        "value": "string"      }    },    "created_at": "string",    "updated_at": "string"  }}