academyFIVE API Beta icon

academyFIVE API Beta

Interact with academyFIVE API

Actions482

Lecturer-contract-employments [Beta] → Create a new lecturer contract employment

AI-generated

Summary

Create a lecturer contract employment for the specified lecturer contract, sending its teaching units, dates, occupation type, and optional employment details and working days to the academyFIVE API.

Inputs

  • type (required) — Resource type string for the lecturer contract employment.
  • attributes.teachingUnits (required) — Number of teaching units.
  • attributes.startDate (required) — Employment start date as a string.
  • attributes.endDate (required) — Employment end date as a string.
  • attributes.occupationTypeId (required) — Occupation type ID: 1 for Internal or 2 for External.
  • attributes.capacity — Optional numeric capacity.
  • attributes.workingDays — Optional working day values using ISO 8601 numbering: 1=Monday through 7=Sunday. Requires Teaching load PRO to be active.
  • relationships.lecturerContract.data.type (required) — Resource type string for the linked lecturer contract.
  • relationships.lecturerContract.data.id (required) — ID of the lecturer contract.
  • relationships.lecturerContractEmploymentStatus.data.type (required) — Resource type string for the linked employment status.
  • relationships.lecturerContractEmploymentStatus.data.id (required) — Employment status ID, available in academyFIVE under Settings → Lecturer contracts → Status values employments.

Output shape

A list of JSON items containing the API response.

The node sends the request using its academyFIVE API credentials and pairs response items with their input item. If Continue On Fail is enabled, failures are returned as items with an error field.

Links

Discussion