Construction Foreman

Template Overview

Template ID: construction-foreman-agreement
Version: 2.0.0

To generate this document, pass the structured data described below into the data property of the /api/v1/documents/generate endpoint.

Data Payload Schema

Field	Type	Requirement	Description & Details
`effectiveDate`	`string`	No	Insert Date of Offer Letter This is the date the letter. You may want to backdate or post date the letter. (Format: `YYYY-MM-DD`.)
`firstName`	`string`	No	First Name Please use the full name, as is on the passport or any other official documents of the party.
`lastName`	`string`	No	Last Name
`address`	`string`	No	Address (number & street)
`town`	`string`	No	Address (Town)
`city`	`string`	No	Address (State/City)
`country`	`string`	No	Country Must be a valid value from the Supported Countries list.
`commencementDate`	`string`	No	Insert Commencement Date (Format: `YYYY-MM-DD`.)
`reportingLine`	`string`	No	Insert Reporting line for this employee This is who the employee will report to in your organisation. Ex: HR Manager
`fixed`	`boolean`	No	Is the employment for a fixed period? If you select “Yes”, the employee only works for a limited period instead of working until they resign or their employment is terminated
`employmentDuration`	`string`	Conditional	How long will the Employee be employed for? Ex: 6 months Required if `fixed` is `true`.
`part_time`	`boolean`	No	Is it a full-time or part-time role? Part-time includes only working particular days in the work week or half days. Values: `true` (Part-time), `false` (Full-time).
`maximumHours`	`string`	Conditional	Insert maximum shift hours per week Required if `part_time` is `true`.
`probationClause`	`boolean`	No	Is there a probation period?
`probation`	`string`	Conditional	Insert the probation period Ex: 12 months. Required if `probationClause` is `true`.
`salaryFrequency`	`string`	No	How often will the salary be paid? Options: `"Weekly"`, `"Monthly"`, `"Annually"`
`currency`	`string`	No	What is the currency of payment? Options: `"NGN"`, `"USD"`, `"GBP"`, `"ZAR"`, `"Others"`
`customCurrency`	`string`	Conditional	Insert the currency Required if `currency` is `"Others"`.
`grossSalary`	`number`	No	What is the Gross salary? This is the employee’s total salary inclusive of taxes and any deductions
`isEquipment`	`boolean`	No	Will the employee be receiving any equipment to carry out their role?
`equipments`	`array of strings`	Conditional	What equipment will the employee be receiving? Ex: Laptop, Phone, etc Required if `isEquipment` is `true`.
`isBenefits`	`boolean`	No	Will the employee be entitled to any benefits?
`benefits`	`array of strings`	Conditional	What benefits will the employee be receiving? Ex: Monthly data allowance of ZAR 15,000 Required if `isBenefits` is `true`.
`startingTime`	`string`	No	When is the Employee's official resumption time? Ex: 9am
`closingTime`	`string`	No	When is the Employee's official closing time? Ex: 5pm
`workingDays`	`string`	No	What days is the Employee expected to report to work? Options: `"Monday to Fridays"`, `"Monday to Saturday"`, `"All 7 days of the week"`, `"Three days a week"`
`leaveDays`	`string`	No	How many leave days is the Employee entitled to? Ex: 20
`sickLeave`	`string`	No	How many working days of sick leave is the Employee entitled to? Ex: 20
`priorNotice`	`string`	No	How long is the notice of termination? Ex: 1 month
`duties`	`array of strings`	No	Add the Employee’s tasks/responsibilities
`dispute`	`boolean`	No	Governing law and Dispute resolution Values: `true` (By Arbitration), `false` (By the court).
`governingLaw`	`string`	No	What is the governing law? Must be a valid value from the Supported Countries list.
`management`	`string`	No	Who will be signing on behalf of the Employer?

Example JSON Payload

Here is an example of a properly formatted data object for the Construction Foreman template.

{
  "templateId": "construction-foreman-agreement",
  "data": {
    "effectiveDate": "2026-06-01",
    "firstName": "Joshua",
    "lastName": "Odelola",
    "address": "123 Beta Way, Lagos",
    "town": "Sample Town",
    "city": "Sample City",
    "country": "Nigeria",
    "commencementDate": "2026-06-01",
    "reportingLine": "HR Manager",
    "fixed": true,
    "employmentDuration": "6 months",
    "part_time": true,
    "maximumHours": "Sample Maximum Hours",
    "probationClause": true,
    "probation": "12 months",
    "salaryFrequency": "Weekly",
    "currency": "NGN",
    "grossSalary": 100000,
    "isEquipment": true,
    "equipments": [
      "Laptop",
      "Phone",
      "etc"
    ],
    "isBenefits": true,
    "benefits": [
      "Monthly data allowance of ZAR 15,000"
    ],
    "startingTime": "9am",
    "closingTime": "5pm",
    "workingDays": "Monday to Fridays",
    "leaveDays": "20",
    "sickLeave": "20",
    "priorNotice": "1 month",
    "duties": [
      "Sample Duties"
    ],
    "dispute": true,
    "governingLaw": "Nigeria",
    "management": "Joshua Odelola"
  },
  "format": "pdf"
}