View as Markdown
Tellent HR icon

Tellent HR ACTION

Update Employee Record

Update an existing employee's record in kiwiHR. See the documentation
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Tellent HR account once, then configure and run Update Employee Record from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "kiwihr-update-employee-record",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    kiwihr: { authProvisionId: "apn_xxxxxxx" },
    employeeId: "Employee ID",
    firstName: "First Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Employee Record inputs
Property Type Description
employeeId Employee ID string
ID of the employee you want to update
Required Dynamic
firstName First Name string
The first name of the employee
Optional
lastName Last Name string
The last name of the employee
Optional
workPhones Work Phones string[]
A list of employee's work phone numbers
Optional
employmentStartDate Employment Start Date string
User's work started date. Format YYYY-MM-DD
Optional
aboutMe About Me string
Short info about the user
Optional
gender Gender string
The gender of the employee
Optional
managerId Manager ID string
ID of the user's manager
Optional Dynamic
nationality Nationality string
2-digit Employee's nationality in ISO 3166-1
Optional
teamIds Team IDs string[]
List of IDs of teams user belongs to
Optional Dynamic
positionId Position ID string
Employee's position ID
Optional Dynamic
locationId Location ID string
Employee's location ID
Optional Dynamic
birthDate Birth Date string
Employee's date of birth
Optional
personalPhone Personal Phone string
Employee's personal phone number
Optional
personalEmail Personal Email string
Employee's personal email address
Optional
addressStreet Street string
The employee's street address
Optional
addressCity City string
The employee's city address
Optional
addressState State string
The employee's state address
Optional
addressPostalCode Postal Code string
The employee's postal code address
Optional
addressCountry Country string
The employee's country address
Optional
pronouns pronouns string
The employee's pronouns
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
kiwihr-update-employee-record
Version
1.0.0
App
Tellent HR
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes