Employees
Partially update an existing employee
Applies a JSON Merge Patch (RFC 7386) to the employee. Send only the fields you want to change - absent fields keep their current value, present fields are applied, and an explicit null clears an optional field. Accepts the same fields as PUT. Fields managed by dedicated endpoints (starterDetails, leaverDetails, payrollId, payrollConfigId, opening balances) are rejected with a 400. Nested objects merge recursively; arrays replace wholesale. The fields required on an employee (name, email, birthGender, birthDate, hoursWorkedCategory) cannot be cleared.
PATCH
/
employees
/
{employeeId}
Partially update an existing employee
curl --request PATCH \
--url https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId} \
--header 'Content-Type: application/json' \
--header 'X-Auth-Token: <api-key>' \
--header 'X-Org-Id: <api-key>' \
--data '
{
"email": "john.smith@company.com",
"taxCodesPerYear": {
"2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": false
}
]
},
"birthGender": "Male",
"phone": "+447700900123",
"birthDate": "1985-07-23",
"maritalStatus": "Married",
"hoursWorkedCategory": "Above30Hours",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": true,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": {
"2026": {
"grossTaxable": 15000,
"tax": 3000
}
},
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": [
"John Doe"
],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": false,
"isOffPayrollWorker": false,
"workplaceDetails": {
"workplacePostcode": "E1 6AN"
},
"workingDays": {
"standardWorkingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard"
},
"partnerDetails": {
"nationalInsuranceNumber": "QQ654321A"
},
"department": "Engineering",
"jobTitle": "Software Engineer"
}
'import requests
url = "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}"
payload = {
"email": "john.smith@company.com",
"taxCodesPerYear": { "2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": False
}
] },
"birthGender": "Male",
"phone": "+447700900123",
"birthDate": "1985-07-23",
"maritalStatus": "Married",
"hoursWorkedCategory": "Above30Hours",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": True,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": { "2026": {
"grossTaxable": 15000,
"tax": 3000
} },
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": ["John Doe"],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": False,
"isOffPayrollWorker": False,
"workplaceDetails": { "workplacePostcode": "E1 6AN" },
"workingDays": {
"standardWorkingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard"
},
"partnerDetails": { "nationalInsuranceNumber": "QQ654321A" },
"department": "Engineering",
"jobTitle": "Software Engineer"
}
headers = {
"X-Auth-Token": "<api-key>",
"X-Org-Id": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'X-Auth-Token': '<api-key>',
'X-Org-Id': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'john.smith@company.com',
taxCodesPerYear: {
'2025': [
{
code: '1257L',
effectiveDate: '2025-04-06',
reason: 'HMRC Update',
issuedBy: 'HMRC',
week1Month1: false
}
]
},
birthGender: 'Male',
phone: '+447700900123',
birthDate: '1985-07-23',
maritalStatus: 'Married',
hoursWorkedCategory: 'Above30Hours',
salary: 35000,
employeeCode: 'EMP001',
secondaryEmail: 'john.secondary@company.com',
address: {
line1: '123 Main Street',
line2: 'Apt 4B',
city: 'London',
county: 'Greater London',
postcode: 'SW1A 1AA',
countryCode: 'GB'
},
bankAccounts: [
{
accountNumber: '12345678',
sortCode: '123456',
allocationPercentage: 100,
isPrimaryPayrollAccount: true,
accountHolderName: 'John Smith'
}
],
studentDetails: {
studentLoanDetails: {loanType: 'Plan2', startDate: '2010-09-01', endDate: '2025-07-31'},
postgraduateLoanDetails: {loanType: 'PostgraduateLoan', startDate: '2015-09-01', endDate: '2028-07-31'}
},
tags: [{name: 'FullTime', group: 'EmploymentType', value: 'FullTime'}],
previousEmployment: {'2026': {grossTaxable: 15000, tax: 3000}},
gender: 'Male',
secondaryPhone: '+447700900124',
passportNumber: '123456789',
previousNames: ['John Doe'],
directorDetails: {
directorsNICType: 'Annual',
appointmentDate: '2024-01-15',
endDate: '2025-03-31'
},
isIrregularEmployment: false,
isOffPayrollWorker: false,
workplaceDetails: {workplacePostcode: 'E1 6AN'},
workingDays: {
standardWorkingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
shiftPattern: {
rotationStartDate: '2024-01-01',
shifts: [
{
name: 'Morning Shift',
workingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
durationInDays: 5
},
{
name: 'Night Shift',
workingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
durationInDays: 5
}
],
patternType: 'FourOnFourOff'
},
workingPattern: 'Standard'
},
partnerDetails: {nationalInsuranceNumber: 'QQ654321A'},
department: 'Engineering',
jobTitle: 'Software Engineer'
})
};
fetch('https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'john.smith@company.com',
'taxCodesPerYear' => [
'2025' => [
[
'code' => '1257L',
'effectiveDate' => '2025-04-06',
'reason' => 'HMRC Update',
'issuedBy' => 'HMRC',
'week1Month1' => false
]
]
],
'birthGender' => 'Male',
'phone' => '+447700900123',
'birthDate' => '1985-07-23',
'maritalStatus' => 'Married',
'hoursWorkedCategory' => 'Above30Hours',
'salary' => 35000,
'employeeCode' => 'EMP001',
'secondaryEmail' => 'john.secondary@company.com',
'address' => [
'line1' => '123 Main Street',
'line2' => 'Apt 4B',
'city' => 'London',
'county' => 'Greater London',
'postcode' => 'SW1A 1AA',
'countryCode' => 'GB'
],
'bankAccounts' => [
[
'accountNumber' => '12345678',
'sortCode' => '123456',
'allocationPercentage' => 100,
'isPrimaryPayrollAccount' => true,
'accountHolderName' => 'John Smith'
]
],
'studentDetails' => [
'studentLoanDetails' => [
'loanType' => 'Plan2',
'startDate' => '2010-09-01',
'endDate' => '2025-07-31'
],
'postgraduateLoanDetails' => [
'loanType' => 'PostgraduateLoan',
'startDate' => '2015-09-01',
'endDate' => '2028-07-31'
]
],
'tags' => [
[
'name' => 'FullTime',
'group' => 'EmploymentType',
'value' => 'FullTime'
]
],
'previousEmployment' => [
'2026' => [
'grossTaxable' => 15000,
'tax' => 3000
]
],
'gender' => 'Male',
'secondaryPhone' => '+447700900124',
'passportNumber' => '123456789',
'previousNames' => [
'John Doe'
],
'directorDetails' => [
'directorsNICType' => 'Annual',
'appointmentDate' => '2024-01-15',
'endDate' => '2025-03-31'
],
'isIrregularEmployment' => false,
'isOffPayrollWorker' => false,
'workplaceDetails' => [
'workplacePostcode' => 'E1 6AN'
],
'workingDays' => [
'standardWorkingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'shiftPattern' => [
'rotationStartDate' => '2024-01-01',
'shifts' => [
[
'name' => 'Morning Shift',
'workingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'durationInDays' => 5
],
[
'name' => 'Night Shift',
'workingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'durationInDays' => 5
]
],
'patternType' => 'FourOnFourOff'
],
'workingPattern' => 'Standard'
],
'partnerDetails' => [
'nationalInsuranceNumber' => 'QQ654321A'
],
'department' => 'Engineering',
'jobTitle' => 'Software Engineer'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Auth-Token: <api-key>",
"X-Org-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}"
payload := strings.NewReader("{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-Auth-Token", "<api-key>")
req.Header.Add("X-Org-Id", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}")
.header("X-Auth-Token", "<api-key>")
.header("X-Org-Id", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Auth-Token"] = '<api-key>'
request["X-Org-Id"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}"
response = http.request(request)
puts response.read_body{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {
"name": {
"firstName": "John",
"lastName": "Smith",
"initials": "<string>",
"middleName": "Edward",
"title": "Mr"
},
"email": "john.smith@company.com",
"birthGender": "Male",
"birthDate": "1985-07-23",
"hoursWorkedCategory": "Above30Hours",
"id": "emp_12345",
"payrollConfigId": "payroll_config_001",
"starterDetails": {
"startDate": "2024-01-15",
"starterDeclaration": "ThisIsMyOnlyJob",
"alreadySentToHmrcFps": false,
"secondedDetails": {
"eEACitizen": true,
"ePM6": false,
"stayStatus": "Stay183DaysOrMore"
}
},
"taxCodesPerYear": {
"2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": false
}
]
},
"niDetails": {
"categoriesPerYear": {},
"nationalInsuranceNumber": "QQ123456C"
},
"phone": "+447700900123",
"maritalStatus": "Married",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": true,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": {
"2026": {
"grossTaxable": 15000,
"tax": 3000
}
},
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": [
"John Doe"
],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": false,
"isOffPayrollWorker": false,
"workplaceDetails": {
"workplacePostcode": "E1 6AN"
},
"workingDays": {
"standardWorkingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard",
"explicitSchedule": {
"weeks": [
{
"weekCommencing": "2026-07-06",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
}
}
]
}
},
"partnerDetails": {
"name": {
"firstName": "John",
"lastName": "Smith",
"initials": "<string>",
"middleName": "Edward",
"title": "Mr"
},
"nationalInsuranceNumber": "QQ654321A"
},
"department": "Engineering",
"jobTitle": "Software Engineer",
"payrollIdChanged": {
"oldPayId": "<string>"
},
"isLeaver": true,
"leaverDetails": {
"finalisedOnPayslip": true,
"leavingDate": "2024-12-31",
"reason": "Retirement",
"issuedBy": "Employer",
"reportedToHmrc": false
},
"earningsToDatePerYear": {},
"openingBalance": {},
"openingBalanceDirector": {},
"directorEarningsToDatePerYear": {},
"payrollId": "PAY123",
"salaryHistory": {
"versions": [
{
"effectiveFrom": "2026-04-06",
"annualSalary": 52000,
"reason": "Annual review",
"createdDate": "<string>",
"createdBy": "<string>",
"updatedDate": "<string>",
"updatedBy": "<string>"
}
],
"inForce": {
"effectiveFrom": "2026-04-06",
"annualSalary": 52000,
"reason": "Annual review",
"createdDate": "<string>",
"createdBy": "<string>",
"updatedDate": "<string>",
"updatedBy": "<string>"
}
},
"createdDate": "2023-01-15T10:00:00Z",
"createdBy": "admin@company.com",
"updatedDate": "2023-06-01T12:00:00Z",
"updatedBy": "hr@company.com"
},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}Authorizations
Access token obtained from OAuth2 client credentials flow
Organisation to scope the request to. Required when the principal can access more than one organisation; optional for single-organisation principals (the authorizer resolves it automatically).
Path Parameters
Body
application/json
Show child attributes
Show child attributes
Example:
"john.smith@company.com"
Tax codes for the employee per tax year
Show child attributes
Show child attributes
Example:
{
"2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": false
}
]
}
National Insurance details for the employee
Show child attributes
Show child attributes
Available options:
Male, Female Example:
"Male"
Example:
"+447700900123"
Example:
"1985-07-23"
Available options:
Single, Married, Divorced, Widowed, CivilPartnership, FormerCivilPartnership, SurvivorCivilPartnership Example:
"Married"
Available options:
UpTo16Hours, From16To24Hours, From24To30Hours, Above30Hours, Other Example:
"Above30Hours"
Deprecated as input on PUT and PATCH: record salary changes with PUT /employees/{employeeId}/salary instead, which keeps an effective-dated history the pay run pro-rates from. While still accepted, a value that differs from the salary in force today updates the most recent salary version in place; null or absent leaves the history untouched. Accepted unchanged on POST /employees, where it becomes the first salary version effective from the start date. Always populated on responses as the annual salary in force today (or the earliest version when every version is still in the future). Will be removed from input in a future version.
Example:
35000
Employee code. An optional identifier for the employee.
Example:
"EMP001"
Example:
"john.secondary@company.com"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The student details of the employee
Show child attributes
Show child attributes
Example:
{
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
}
Show child attributes
Show child attributes
Earnings from a previous employer in the same tax year. Used for cumulative tax calculations only. Does not affect FPS reporting.
Show child attributes
Show child attributes
Example:
{
"2026": { "grossTaxable": 15000, "tax": 3000 }
}
Example:
"Male"
Example:
"+447700900124"
Example:
"123456789"
Example:
["John Doe"]
Show child attributes
Show child attributes
Example:
false
Example:
false
Show child attributes
Show child attributes
Configuration of employee's working days
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"Engineering"
Example:
"Software Engineer"
Was this page helpful?
⌘I
Partially update an existing employee
curl --request PATCH \
--url https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId} \
--header 'Content-Type: application/json' \
--header 'X-Auth-Token: <api-key>' \
--header 'X-Org-Id: <api-key>' \
--data '
{
"email": "john.smith@company.com",
"taxCodesPerYear": {
"2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": false
}
]
},
"birthGender": "Male",
"phone": "+447700900123",
"birthDate": "1985-07-23",
"maritalStatus": "Married",
"hoursWorkedCategory": "Above30Hours",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": true,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": {
"2026": {
"grossTaxable": 15000,
"tax": 3000
}
},
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": [
"John Doe"
],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": false,
"isOffPayrollWorker": false,
"workplaceDetails": {
"workplacePostcode": "E1 6AN"
},
"workingDays": {
"standardWorkingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard"
},
"partnerDetails": {
"nationalInsuranceNumber": "QQ654321A"
},
"department": "Engineering",
"jobTitle": "Software Engineer"
}
'import requests
url = "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}"
payload = {
"email": "john.smith@company.com",
"taxCodesPerYear": { "2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": False
}
] },
"birthGender": "Male",
"phone": "+447700900123",
"birthDate": "1985-07-23",
"maritalStatus": "Married",
"hoursWorkedCategory": "Above30Hours",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": True,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": { "2026": {
"grossTaxable": 15000,
"tax": 3000
} },
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": ["John Doe"],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": False,
"isOffPayrollWorker": False,
"workplaceDetails": { "workplacePostcode": "E1 6AN" },
"workingDays": {
"standardWorkingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": True,
"tuesday": True,
"wednesday": True,
"thursday": True,
"friday": True,
"saturday": False,
"sunday": False
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard"
},
"partnerDetails": { "nationalInsuranceNumber": "QQ654321A" },
"department": "Engineering",
"jobTitle": "Software Engineer"
}
headers = {
"X-Auth-Token": "<api-key>",
"X-Org-Id": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'X-Auth-Token': '<api-key>',
'X-Org-Id': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'john.smith@company.com',
taxCodesPerYear: {
'2025': [
{
code: '1257L',
effectiveDate: '2025-04-06',
reason: 'HMRC Update',
issuedBy: 'HMRC',
week1Month1: false
}
]
},
birthGender: 'Male',
phone: '+447700900123',
birthDate: '1985-07-23',
maritalStatus: 'Married',
hoursWorkedCategory: 'Above30Hours',
salary: 35000,
employeeCode: 'EMP001',
secondaryEmail: 'john.secondary@company.com',
address: {
line1: '123 Main Street',
line2: 'Apt 4B',
city: 'London',
county: 'Greater London',
postcode: 'SW1A 1AA',
countryCode: 'GB'
},
bankAccounts: [
{
accountNumber: '12345678',
sortCode: '123456',
allocationPercentage: 100,
isPrimaryPayrollAccount: true,
accountHolderName: 'John Smith'
}
],
studentDetails: {
studentLoanDetails: {loanType: 'Plan2', startDate: '2010-09-01', endDate: '2025-07-31'},
postgraduateLoanDetails: {loanType: 'PostgraduateLoan', startDate: '2015-09-01', endDate: '2028-07-31'}
},
tags: [{name: 'FullTime', group: 'EmploymentType', value: 'FullTime'}],
previousEmployment: {'2026': {grossTaxable: 15000, tax: 3000}},
gender: 'Male',
secondaryPhone: '+447700900124',
passportNumber: '123456789',
previousNames: ['John Doe'],
directorDetails: {
directorsNICType: 'Annual',
appointmentDate: '2024-01-15',
endDate: '2025-03-31'
},
isIrregularEmployment: false,
isOffPayrollWorker: false,
workplaceDetails: {workplacePostcode: 'E1 6AN'},
workingDays: {
standardWorkingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
shiftPattern: {
rotationStartDate: '2024-01-01',
shifts: [
{
name: 'Morning Shift',
workingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
durationInDays: 5
},
{
name: 'Night Shift',
workingDays: {
monday: true,
tuesday: true,
wednesday: true,
thursday: true,
friday: true,
saturday: false,
sunday: false
},
durationInDays: 5
}
],
patternType: 'FourOnFourOff'
},
workingPattern: 'Standard'
},
partnerDetails: {nationalInsuranceNumber: 'QQ654321A'},
department: 'Engineering',
jobTitle: 'Software Engineer'
})
};
fetch('https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'john.smith@company.com',
'taxCodesPerYear' => [
'2025' => [
[
'code' => '1257L',
'effectiveDate' => '2025-04-06',
'reason' => 'HMRC Update',
'issuedBy' => 'HMRC',
'week1Month1' => false
]
]
],
'birthGender' => 'Male',
'phone' => '+447700900123',
'birthDate' => '1985-07-23',
'maritalStatus' => 'Married',
'hoursWorkedCategory' => 'Above30Hours',
'salary' => 35000,
'employeeCode' => 'EMP001',
'secondaryEmail' => 'john.secondary@company.com',
'address' => [
'line1' => '123 Main Street',
'line2' => 'Apt 4B',
'city' => 'London',
'county' => 'Greater London',
'postcode' => 'SW1A 1AA',
'countryCode' => 'GB'
],
'bankAccounts' => [
[
'accountNumber' => '12345678',
'sortCode' => '123456',
'allocationPercentage' => 100,
'isPrimaryPayrollAccount' => true,
'accountHolderName' => 'John Smith'
]
],
'studentDetails' => [
'studentLoanDetails' => [
'loanType' => 'Plan2',
'startDate' => '2010-09-01',
'endDate' => '2025-07-31'
],
'postgraduateLoanDetails' => [
'loanType' => 'PostgraduateLoan',
'startDate' => '2015-09-01',
'endDate' => '2028-07-31'
]
],
'tags' => [
[
'name' => 'FullTime',
'group' => 'EmploymentType',
'value' => 'FullTime'
]
],
'previousEmployment' => [
'2026' => [
'grossTaxable' => 15000,
'tax' => 3000
]
],
'gender' => 'Male',
'secondaryPhone' => '+447700900124',
'passportNumber' => '123456789',
'previousNames' => [
'John Doe'
],
'directorDetails' => [
'directorsNICType' => 'Annual',
'appointmentDate' => '2024-01-15',
'endDate' => '2025-03-31'
],
'isIrregularEmployment' => false,
'isOffPayrollWorker' => false,
'workplaceDetails' => [
'workplacePostcode' => 'E1 6AN'
],
'workingDays' => [
'standardWorkingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'shiftPattern' => [
'rotationStartDate' => '2024-01-01',
'shifts' => [
[
'name' => 'Morning Shift',
'workingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'durationInDays' => 5
],
[
'name' => 'Night Shift',
'workingDays' => [
'monday' => true,
'tuesday' => true,
'wednesday' => true,
'thursday' => true,
'friday' => true,
'saturday' => false,
'sunday' => false
],
'durationInDays' => 5
]
],
'patternType' => 'FourOnFourOff'
],
'workingPattern' => 'Standard'
],
'partnerDetails' => [
'nationalInsuranceNumber' => 'QQ654321A'
],
'department' => 'Engineering',
'jobTitle' => 'Software Engineer'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Auth-Token: <api-key>",
"X-Org-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}"
payload := strings.NewReader("{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-Auth-Token", "<api-key>")
req.Header.Add("X-Org-Id", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}")
.header("X-Auth-Token", "<api-key>")
.header("X-Org-Id", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.flowpayroll.ai/v1/employees/{employeeId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Auth-Token"] = '<api-key>'
request["X-Org-Id"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"john.smith@company.com\",\n \"taxCodesPerYear\": {\n \"2025\": [\n {\n \"code\": \"1257L\",\n \"effectiveDate\": \"2025-04-06\",\n \"reason\": \"HMRC Update\",\n \"issuedBy\": \"HMRC\",\n \"week1Month1\": false\n }\n ]\n },\n \"birthGender\": \"Male\",\n \"phone\": \"+447700900123\",\n \"birthDate\": \"1985-07-23\",\n \"maritalStatus\": \"Married\",\n \"hoursWorkedCategory\": \"Above30Hours\",\n \"salary\": 35000,\n \"employeeCode\": \"EMP001\",\n \"secondaryEmail\": \"john.secondary@company.com\",\n \"address\": {\n \"line1\": \"123 Main Street\",\n \"line2\": \"Apt 4B\",\n \"city\": \"London\",\n \"county\": \"Greater London\",\n \"postcode\": \"SW1A 1AA\",\n \"countryCode\": \"GB\"\n },\n \"bankAccounts\": [\n {\n \"accountNumber\": \"12345678\",\n \"sortCode\": \"123456\",\n \"allocationPercentage\": 100,\n \"isPrimaryPayrollAccount\": true,\n \"accountHolderName\": \"John Smith\"\n }\n ],\n \"studentDetails\": {\n \"studentLoanDetails\": {\n \"loanType\": \"Plan2\",\n \"startDate\": \"2010-09-01\",\n \"endDate\": \"2025-07-31\"\n },\n \"postgraduateLoanDetails\": {\n \"loanType\": \"PostgraduateLoan\",\n \"startDate\": \"2015-09-01\",\n \"endDate\": \"2028-07-31\"\n }\n },\n \"tags\": [\n {\n \"name\": \"FullTime\",\n \"group\": \"EmploymentType\",\n \"value\": \"FullTime\"\n }\n ],\n \"previousEmployment\": {\n \"2026\": {\n \"grossTaxable\": 15000,\n \"tax\": 3000\n }\n },\n \"gender\": \"Male\",\n \"secondaryPhone\": \"+447700900124\",\n \"passportNumber\": \"123456789\",\n \"previousNames\": [\n \"John Doe\"\n ],\n \"directorDetails\": {\n \"directorsNICType\": \"Annual\",\n \"appointmentDate\": \"2024-01-15\",\n \"endDate\": \"2025-03-31\"\n },\n \"isIrregularEmployment\": false,\n \"isOffPayrollWorker\": false,\n \"workplaceDetails\": {\n \"workplacePostcode\": \"E1 6AN\"\n },\n \"workingDays\": {\n \"standardWorkingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"shiftPattern\": {\n \"rotationStartDate\": \"2024-01-01\",\n \"shifts\": [\n {\n \"name\": \"Morning Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n },\n {\n \"name\": \"Night Shift\",\n \"workingDays\": {\n \"monday\": true,\n \"tuesday\": true,\n \"wednesday\": true,\n \"thursday\": true,\n \"friday\": true,\n \"saturday\": false,\n \"sunday\": false\n },\n \"durationInDays\": 5\n }\n ],\n \"patternType\": \"FourOnFourOff\"\n },\n \"workingPattern\": \"Standard\"\n },\n \"partnerDetails\": {\n \"nationalInsuranceNumber\": \"QQ654321A\"\n },\n \"department\": \"Engineering\",\n \"jobTitle\": \"Software Engineer\"\n}"
response = http.request(request)
puts response.read_body{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {
"name": {
"firstName": "John",
"lastName": "Smith",
"initials": "<string>",
"middleName": "Edward",
"title": "Mr"
},
"email": "john.smith@company.com",
"birthGender": "Male",
"birthDate": "1985-07-23",
"hoursWorkedCategory": "Above30Hours",
"id": "emp_12345",
"payrollConfigId": "payroll_config_001",
"starterDetails": {
"startDate": "2024-01-15",
"starterDeclaration": "ThisIsMyOnlyJob",
"alreadySentToHmrcFps": false,
"secondedDetails": {
"eEACitizen": true,
"ePM6": false,
"stayStatus": "Stay183DaysOrMore"
}
},
"taxCodesPerYear": {
"2025": [
{
"code": "1257L",
"effectiveDate": "2025-04-06",
"reason": "HMRC Update",
"issuedBy": "HMRC",
"week1Month1": false
}
]
},
"niDetails": {
"categoriesPerYear": {},
"nationalInsuranceNumber": "QQ123456C"
},
"phone": "+447700900123",
"maritalStatus": "Married",
"salary": 35000,
"employeeCode": "EMP001",
"secondaryEmail": "john.secondary@company.com",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "London",
"county": "Greater London",
"postcode": "SW1A 1AA",
"countryCode": "GB"
},
"bankAccounts": [
{
"accountNumber": "12345678",
"sortCode": "123456",
"allocationPercentage": 100,
"isPrimaryPayrollAccount": true,
"accountHolderName": "John Smith"
}
],
"studentDetails": {
"studentLoanDetails": {
"loanType": "Plan2",
"startDate": "2010-09-01",
"endDate": "2025-07-31"
},
"postgraduateLoanDetails": {
"loanType": "PostgraduateLoan",
"startDate": "2015-09-01",
"endDate": "2028-07-31"
}
},
"tags": [
{
"name": "FullTime",
"group": "EmploymentType",
"value": "FullTime"
}
],
"previousEmployment": {
"2026": {
"grossTaxable": 15000,
"tax": 3000
}
},
"gender": "Male",
"secondaryPhone": "+447700900124",
"passportNumber": "123456789",
"previousNames": [
"John Doe"
],
"directorDetails": {
"directorsNICType": "Annual",
"appointmentDate": "2024-01-15",
"endDate": "2025-03-31"
},
"isIrregularEmployment": false,
"isOffPayrollWorker": false,
"workplaceDetails": {
"workplacePostcode": "E1 6AN"
},
"workingDays": {
"standardWorkingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"shiftPattern": {
"rotationStartDate": "2024-01-01",
"shifts": [
{
"name": "Morning Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
},
{
"name": "Night Shift",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
},
"durationInDays": 5
}
],
"patternType": "FourOnFourOff"
},
"workingPattern": "Standard",
"explicitSchedule": {
"weeks": [
{
"weekCommencing": "2026-07-06",
"workingDays": {
"monday": true,
"tuesday": true,
"wednesday": true,
"thursday": true,
"friday": true,
"saturday": false,
"sunday": false
}
}
]
}
},
"partnerDetails": {
"name": {
"firstName": "John",
"lastName": "Smith",
"initials": "<string>",
"middleName": "Edward",
"title": "Mr"
},
"nationalInsuranceNumber": "QQ654321A"
},
"department": "Engineering",
"jobTitle": "Software Engineer",
"payrollIdChanged": {
"oldPayId": "<string>"
},
"isLeaver": true,
"leaverDetails": {
"finalisedOnPayslip": true,
"leavingDate": "2024-12-31",
"reason": "Retirement",
"issuedBy": "Employer",
"reportedToHmrc": false
},
"earningsToDatePerYear": {},
"openingBalance": {},
"openingBalanceDirector": {},
"directorEarningsToDatePerYear": {},
"payrollId": "PAY123",
"salaryHistory": {
"versions": [
{
"effectiveFrom": "2026-04-06",
"annualSalary": 52000,
"reason": "Annual review",
"createdDate": "<string>",
"createdBy": "<string>",
"updatedDate": "<string>",
"updatedBy": "<string>"
}
],
"inForce": {
"effectiveFrom": "2026-04-06",
"annualSalary": 52000,
"reason": "Annual review",
"createdDate": "<string>",
"createdBy": "<string>",
"updatedDate": "<string>",
"updatedBy": "<string>"
}
},
"createdDate": "2023-01-15T10:00:00Z",
"createdBy": "admin@company.com",
"updatedDate": "2023-06-01T12:00:00Z",
"updatedBy": "hr@company.com"
},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}{
"message": {
"text": "<string>",
"token": "<string>",
"tokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
},
"content": {
"data": {},
"metadata": {
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ",
"paginationToken": "<string>"
}
},
"validationIssues": [
{
"field": "<string>",
"reason": "<string>",
"reasonToken": "<string>",
"reasonTokenArguments": [
{
"name": "<string>",
"value": "<string>"
}
]
}
]
}