View as Markdown
Tellent HR icon

Tellent HR ACTION

Create Employee

Add a new employee to kiwiHR. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Tellent HR account once, then configure and run Create Employee 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-create-employee",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    kiwihr: { authProvisionId: "apn_xxxxxxx" },
    firstName: "First Name",
    lastName: "Last 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.

Create Employee inputs
Property Type Description
firstName First Name string
The first name of the employee
Required
lastName Last Name string
The last name of the employee
Required
email Email string
The email of the employee
Required
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-create-employee
Version
1.0.0
App
Tellent HR
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes