Create Employee Job

---

POST /services/api/v1/employee_jobs

Creates a new employee jobs.

Request Body

Example

{
  "employee_id": "rQ6ZV6W5",
  "from": "2024-08-25",
  "to": "2024-12-18",
  "notes": null,
  "time_percentage": 60.0,
  "time_hours": 25.0,
  "time_type": "part_time",
  "time_table": null,
  "classification": null,
  "job_type": "unlimited",
  "supervisor_id": "KRBbJBwN",
  "department_id": "rQ6ZV6W5",
  "location_id": "KRBbJBwN",
  "name": "Regional Manager"
}

Schema

Attribute	Type	Required	Description
name	string	true	Name of the employee job. Usually the job title.
employee_id	string	true	Id of the employee the job belongs to.
from	date	true	Start date of the employee job (ISO8601).
to	date	false	End date of the employee job (ISO8601). Null if unlimited.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Job Fields API endpoint.

Response

201

The created employee job.

Example

{
  "id": "7bBJADz2",
  "employee_id": "rQ6ZV6W5",
  "from": "2024-08-25",
  "to": "2024-12-18",
  "notes": null,
  "time_percentage": 60.0,
  "time_hours": 25.0,
  "time_type": "part_time",
  "time_table": null,
  "classification": null,
  "job_type": "unlimited",
  "supervisor_id": "KRBbJBwN",
  "department_id": "rQ6ZV6W5",
  "location_id": "KRBbJBwN",
  "name": "Regional Manager",
  "created_at": "2024-10-10T13:43:56.347Z",
  "updated_at": "2024-10-14T10:06:50.112Z"
}

Schema

Attribute	Type	Required	Description
id	string	readonly	Id of the employee job.
created_at	datetime	readonly	Employee job creation date.
updated_at	datetime	readonly	Employee job last updated at.
name	string	true	Name of the employee job. Usually the job title.
employee_id	string	true	Id of the employee the job belongs to.
from	date	true	Start date of the employee job (ISO8601).
to	date	false	End date of the employee job (ISO8601). Null if unlimited.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Job Fields API endpoint.

422

Unprocessable Entity.

Example:

{
  "from": ["This field is mandatory."],
  "supervisor_id": ["This field is invalid."]
}

404

The employee id passed in the body was not found.