View as Markdown
Personio icon

Personio ACTION

Create Employee

Creates a new employee. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Personio 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: "personio-create-employee",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    personio: { authProvisionId: "apn_xxxxxxx" },
    email: "Email",
    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.

Create Employee inputs
Property Type Description
email Email string
The e-mail field is required for the employee creation. Updating of this field is not currently supported.
Required
firstName First Name string
The first name of the employee.
Required
lastName Last Name string
The last name of the employee.
Required
gender Gender string
The gender of the employee.
Optional
position Position string
The position of the employee. E.g. developer.
Optional
subcompany Subcompany string
The subcompany employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.
Optional
department Department string
The department employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.
Optional
office Office string
The office employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.
Optional
hireDate Hire Date string
Employee hire date. Format: "yyyy-mm-dd". If status is not provided, it will be set to active if the hire date is in the past, or to onboarding if it's in the future.
Optional
weeklyWorkingHours Weekly Working Hours integer
All hours usually worked, including regular overtime.
Optional
status Status string
Status of the employee. Overrides the status determined based on the value of hire_date.
Optional
supervisorId Supervisor Id string
Employee ID of the Supervisor to be assigned. It needs to belong to a current existing employee, otherwise an error will be returned. If not present, no supervisor will be assigned.
Optional Dynamic
customAttributes Custom Attributes object
Additional attributes to the employee.
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
personio-create-employee
Version
0.0.2
App
Personio
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes