API Reference
Become a Partner

Creating applications in Personio

post
https://api.personio.de/v1/recruiting/applications

Allows you to create applications in Personio.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≥ 1

First name(s) of the applicant. Must not be empty or only whitespaces

string
required
length ≥ 1

Last name(s) of the applicant. Must not be empty or only whitespaces.

string
required

Email address of the applicant.

integer
required

The personio internal id of the job this application should belong to.

integer

The recruiting channel this application was sourced from.

See https://{YOUR_COMPANY}.personio.de/configuration/recruiting/channels

string

The external id of the job posting (E.g. the external id forwarded by Gohiring).

string

The applicant supplied free-text message.

date

The application date (yyyy-mm-dd). It cannot be a date in the future.

phase
object

This can be a system or a custom application phase. When not provided, the application will be created with the initial phase according to the configuration for this job position's category (https://{YOUR_COMPANY}.personio.de/configuration/recruiting/categories).

When an invalid phase is provided (e.g. a non-existent custom phase or one that is not configured for this job position's category), the application will be created with the phase unassigned.

tags
array of strings

Tags to be associated with this application. Non-existing tags will be created.

See https://{YOUR_COMPANY}.personio.de/configuration/recruiting/tags

tags
files
array of objects

References to previously uploaded files. These will be attached to the new application.

Each file item consists of a uuid, an original_filename and a category (To see exact description, click on "ADD OBJECT").

files
attributes
array of objects

Attributes for this applicant.

Each attribute item consists of an id and a value (To see exact description, click on "ADD OBJECT").

attributes
Headers
string

The partner identifier

string

The application identifier

string
required

Your company's Personio Id

Responses
201

Created - Application was created successfully.

401

Unauthorized - The API token and/or company id was not recognized. Please provide a valid API token in as value of an Authorization header, like Bearer api-token-value.

429

Too Many Requests - You have exceeded the rate-limit for your API call.

Updated 3 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago