Skip to main content
POST
/
api
/
webhook
/
v1
/
employee
/
update
Update Employee
curl --request POST \
  --url https://{env}.tartanhq.com/api/webhook/v1/employee/update/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "7",
  "employeeId": "5",
  "name": "Manas Mallik",
  "email": "manas@tartanhq.com",
  "personalEmail": "manas.mallik@gmail.com",
  "doj": "2021-06-01",
  "dob": "1983-06-08",
  "status": "Active",
  "employmentType": "Permanent",
  "gender": "Male",
  "pan": "************",
  "aadhar": "************",
  "uan": "************",
  "mobileNumber": "************",
  "maritalStatus": "Married",
  "nationality": "Indian",
  "fatherName": "Ritesh Mallik",
  "bloodGroup": "AB +ve",
  "designation": "NOT AVAILABLE",
  "department": "Engineering",
  "grade": "D-3",
  "groupName": "NOT AVAILABLE",
  "costCenter": "NOT AVAILABLE",
  "companyName": "NOT AVAILABLE",
  "terminationDate": "",
  "manager": "Meet Semlani",
  "managerEmail": "NOT AVAILABLE",
  "managerEmail2": "NOT AVAILABLE",
  "managerEmail3": "NOT AVAILABLE",
  "managerEmail4": "NOT AVAILABLE",
  "managerEmail5": "NOT AVAILABLE",
  "countryCode": "IN",
  "bankDetails": {
    "accountNumber": "************",
    "ifscCode": "************",
    "bankName": "SBI"
  },
  "currentAddress": {
    "addressPincode": "560080",
    "addressCity": "Banglore",
    "addressCountry": "India",
    "addressState": "Karnataka",
    "addressLine": "Sadashiva Nagar Armane Nagar"
  },
  "permanentAddress": {
    "addressPincode": "226001",
    "addressCity": "Luknow",
    "addressCountry": "India",
    "addressState": "Uttar Pradesh",
    "addressLine": "Yarana Nagar Luknow"
  },
  "jobLocation": {
    "pincode": "NOT AVAILABLE",
    "city": "NOT AVAILABLE"
  },
  "employeeMetadata": {
    "marriageDate": "NOT AVAILABLE"
  },
  "dependentDetails": [
    {
      "name": "Sohan Negi",
      "relation": "Father",
      "dob": "NOT AVAILABLE",
      "email": "NOT AVAILABLE",
      "gender": "NOT AVAILABLE",
      "mobileNumber": "NOT AVAILABLE",
      "profession": "NOT AVAILABLE"
    }
  ],
  "salaryDetails": {
    "ctc": {
      "basic": 50000,
      "dearnessAllowance": 9000.9,
      "hra": 25000.5,
      "gratuity": 2000.7,
      "medicalAllowance": 2000.7,
      "travelAllowance": 2000.7,
      "specialAllowance": null,
      "otherAllowance": null,
      "flexiBasketAllowance": null,
      "grossPay": null,
      "taxRegime": null,
      "fixedPay": null,
      "bonus": {
        "joining": 80000,
        "referral": null,
        "retention": null,
        "performance": null,
        "relocation": null,
        "misc": null
      },
      "deductions": {
        "pf": 1800,
        "esi": null,
        "professionalTax": null,
        "labourWelfareFund": null,
        "misc": null,
        "nps": null
      }
    },
    "monthly": {
      "month": 2,
      "year": 2025,
      "basic": null,
      "dearnessAllowance": null,
      "hra": null,
      "medicalAllowance": null,
      "travelAllowance": null,
      "specialAllowance": null,
      "flexiBasketAllowance": null,
      "gratuity": 1600,
      "otherAllowance": null,
      "taxRegime": null,
      "fixedPay": null,
      "grossPay": null,
      "bonus": {
        "joining": 20000,
        "referral": null,
        "retention": null,
        "performance": null,
        "relocation": 28907.17,
        "misc": null
      },
      "deductions": {
        "pf": null,
        "esi": null,
        "professionalTax": 300,
        "labourWelfareFund": null,
        "tds": null,
        "medicalClaimDeduction": null,
        "groupTermInsuranceDeductions": null,
        "earlyWageDeduction": null,
        "misc": 162023.24,
        "nps": 1234.34
      },
      "reimbursements": 93321.33
    }
  }
}
'

Body

application/json
​
id
string
Example:

"7"

​
employeeId
string
Example:

"5"

​
name
string
Example:

"Manas Mallik"

​
email
string<email> | null
Example:

"manas@tartanhq.com"

​
personalEmail
string<email> | null
Example:

"manas.mallik@gmail.com"

​
doj
string<date>
Example:

"2021-06-01"

​
dob
string<date> | null
Example:

"1983-06-08"

​
status
enum<string>
Available options:
Active,
Inactive,
Terminated
Example:

"Active"

​
employmentType
string | null
Example:

"Permanent"

​
gender
string
Example:

"Male"

​
pan
string | null

Masked PAN

Example:

"************"

​
aadhar
string | null

Masked Aadhaar

Example:

"************"

​
uan
string | null

Masked UAN

Example:

"************"

​
mobileNumber
string | null

Masked mobile number

Example:

"************"

​
maritalStatus
string | null
Example:

"Married"

​
nationality
string | null
Example:

"Indian"

​
fatherName
string | null
Example:

"Ritesh Mallik"

​
bloodGroup
string | null
Example:

"AB +ve"

​
designation
string
Example:

"NOT AVAILABLE"

​
department
string
Example:

"Engineering"

​
grade
string
Example:

"D-3"

​
groupName
string
Example:

"NOT AVAILABLE"

​
costCenter
string
Example:

"NOT AVAILABLE"

​
companyName
string
Example:

"NOT AVAILABLE"

​
terminationDate
string<date> | null
Example:

""

​
manager
string
Example:

"Meet Semlani"

​
managerEmail
string<email> | null
Example:

"NOT AVAILABLE"

​
managerEmail2
string<email> | null
Example:

"NOT AVAILABLE"

​
managerEmail3
string<email> | null
Example:

"NOT AVAILABLE"

​
managerEmail4
string<email> | null
Example:

"NOT AVAILABLE"

​
managerEmail5
string<email> | null
Example:

"NOT AVAILABLE"

​
countryCode
string
Example:

"IN"

​
bankDetails
object
​
currentAddress
object
​
permanentAddress
object
​
jobLocation
object
​
employeeMetadata
object
​
dependentDetails
object[]
​
salaryDetails
object

Response

Employee updated successfully