View as Markdown
Personio icon

Personio ACTION

Create Application

Creates a new application. 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 Application 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-application",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    personio: { authProvisionId: "apn_xxxxxxx" },
    companyId: "Company Id",
    recruitingAccessToken: "Recruiting Access Token",
  },
})

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 Application inputs
Property Type Description
companyId Company Id string
Your company id provided at https://{YOUR_COMPANY}.personio.de/configuration/api/credentials/management
Required
recruitingAccessToken Recruiting Access Token string
Your recruiting access Token provided at https://{YOUR_COMPANY}.personio.de/configuration/api/credentials/management
Required
firstName First Name string
First name(s) of the applicant. Must not be empty or only whitespaces.
Required
lastName Last Name string
Last name(s) of the applicant. Must not be empty or only whitespaces.
Required
email Email string
Email address of the applicant.
Required
jobPositionId Job Position Id integer
The personio internal id of the job this application should belong to. Access your positions page at https://{YOUR_COMPANY}.personio.de/recruiting/positions; Select a position; If your current URL is https://{YOUR_COMPANY}.personio.de/recruiting/positions/12345, then your Job Position ID is 12345
Required
recruitingChannelId Recruiting Channel Id string
The recruiting channel this application was sourced from. See https://{YOUR_COMPANY}.personio.de/configuration/recruiting/channels.
Optional
externalPostingId External Posting Id string
The external id of the job posting (E.g. the external id forwarded by Gohiring).
Optional
message Message string
The applicant supplied free-text message.
Optional
applicationDate Application Date string
The application date (yyyy-mm-dd). It cannot be a date in the future.
Optional
tags Tags string[]
Tags to be associated with this application. Non-existing tags will be created. See https://{YOUR_COMPANY}.personio.de/configuration/recruiting/tags.
Optional
files Files string[]
A list of references to previously updated files. These will be attached to the new application. Each file item consists of an uuid, an original_filename and a category. See the documentation.
Optional
attributes Attributes string[]
A list of attributes for this applicant. Each attribute item consists of an id and a value. See the documentation.
Optional
phaseType Phase Type string
The type of application phase.
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-application
Version
0.0.2
App
Personio
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes