Update Employee Details

Updates personal and employment details for an existing employee record.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Supported Apps

Here are the list of apps that support this API.

Workday (workday)
Paychex (paychex)
Paylocity (paylocity)
Paycor (paycor)
  • The fields not supported by this API for Paycorare:

    • employment -> workShiftId

    • workAddress -> addressLine1, addressLine2, city, state, country, zipCode

    • presentAddress

Hibob (hibob)
Sage (sage-hris)
BambooHR (bamboohr)
Personio (personio)
Darwinbox (darwinbox)
  • Darwinbox only takes in 1 personal email for an employee. If you pass more than one email, only the first will be taken and rest will be ignored

    • The fields not supported by this API for Darwinbox are:

    • employment

    • workAddress

Zoho People (zoho-people)
  • Zoho People only takes in 1 personal email for an employee. If you pass more than one email, only the first will be taken and rest will be ignored

  • The fields not supported by this API for Zoho People are:

    • employment -> workShiftId
    • workAddress
    • presentAddress
SAP SuccessFactors (successfactors)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • personalEmails
  • presentAddress
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.state
  • presentAddress.country
  • presentAddress.zipCode
  • employment
  • employment.positionId
  • metadata

Additional Metadata:

  • metadata.payScaleArea - Required
  • metadata.payScaleType - Required
Oracle Cloud HCM (oracle-hcm)
  • Oracle HCM only takes in 1 personal email for an employee. If you pass more than one email, only the first will be taken and rest will be ignored
Remote (remote)
Deel (deel)
Humaans (humaans)
7shifts (7shifts)
Alexis HR (alexishr)
UKG Ready (ukgready)
IRIS Cascade (iriscascade)
People HR (peopleHR)
Kallidus (kallidus)
Folks HR (folkshr)

You must include the following fields in the metadata field:

  • employeeNumber(Unique identifier in the company.)
OneLogin (onelogin)
PrismHR (prismhr)

Refer api specific guides - PrismHR API Guide

Avionte (avionte)
ADP Workforce Now (adp-workforcenow-hris)
Namely (namely)
Lucca HR (luccahr)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • personalEmails
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.state
  • presentAddress.country
  • presentAddress.zipCode
  • employment.designation
  • companyId
  • department
  • employeeNumber
  • startDate
  • birthDate
  • gender
  • phones
  • manager.id
TimeTac (timetac)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.country
  • presentAddress.zipCode

Additional Metadata:

  • Any additional key-value pairs can be passed in metadata and will be forwarded to the TimeTac API

Supported Response Fields:

  • employeeId
Microsoft Entra (microsoft-entra)
HR Works (hr-works)

Supported Request Fields:

  • firstName
  • lastName
  • workEmail
  • gender - Allowed values - male female diverse not specified
  • employmentType - Allowed values - apprentice externalWorker intern marginalEmployment regularEmployee shortTermEmployment studentTrainee
  • startDate - YYYY-MM-DD format
  • birthDate - YYYY-MM-DD format
  • department - department Id obtained using list all departments API
  • phones - only of one phone number of type WORK is honored.
  • manager.id
  • employment.designation
  • presentAddress

Additional Metadata:

  • metadata.personId - Required, The user id assigned to the person. Used as the login name. Unique identifier.

  • metadata.personnelNumber - Required, The personnel number assigned to the person. Unique identifier.

  • Any key-value pairs can be passed in metadata and will be forwarded to the HR Works API

Makeshift (makeshift)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • employeeNumber
  • phones
  • startDate
  • employmentType
  • employment.designation

Additional Metadata:

  • Any key-value pairs can be passed in metadata object

Supported Response Fields:

  • No specific response data fields (returns default success response)

Remarks
You can set employmentType to full_time, part_time or casual. employment. designation can be employee, department_admin, location-admin, company_admin.

Sesame HR (sesamehr)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • gender
  • employment.positionId
  • employment.designation
  • personalEmails
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.state
  • presentAddress.country
  • presentAddress.zipCode

Additional Metadata:

  • Any custom fields can be passed in metadata
Xero Payroll (xero-payroll)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • employment.designation
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.state
  • presentAddress.country
  • presentAddress.zipCode
  • metadata
Netsuite Payroll (netsuite-payroll)

Supported Request Fields:

  • employeeId - Required
  • firstName
  • lastName
  • workEmail
  • employment.designation
  • employment.positionId
  • workAddress.addressLine1
  • workAddress.addressLine2
  • workAddress.city
  • workAddress.state
  • workAddress.country
  • `workAddress.zipCode
  • presentAddress.addressLine1
  • presentAddress.addressLine2
  • presentAddress.city
  • presentAddress.state
  • presentAddress.country
  • `presentAddress.zipCode
  • metadata
Body Params
string
required
string
string
string
personalEmails
array of strings
personalEmails
presentAddress
object
workAddress
object
employment
object
string

JSON-formatted string containing set of key-value attributes to provide additional data

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json