Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Passing applications to Personio

Description of the applicant endpoint of the Personio Recruiting API

The API access token as well as the company ID can be found in your Personio account under configure account > company.

A POST must be sent to https://api.personio.de/recruiting/applicant. The request can contain the following parameters:

name
description
type
optional

company_id

Your company ID (see above)

integer

access_token

API Access token for your company account (see above)

string

job_position_id

ID of the job that this application is for (from XML feed)

string

first_name

First name of the applicant

string

last_name

Last name of the applicant

string

email

Email address of the applicant

string

gender

Gender of the applicant

Enum (male | female)

yes

recruiting_channel_id

ID of the recruiting channel that this applicant applied through recruiting_channel_id has to match the id of a channel you created in Personio

integer

phone

Phone number of the applicant

string

yes

location

Current location of the applicant

string

yes

salary_expectations

Salary expectations of the applicant (Will not be parsed, so you can transfer values like "minimum 50k")

string

yes

available_from

Date from which this applicant is available from

string

yes

documents[]

Array of documents that are attached to this application

[array of files]
allowed extensions are 'pdf', 'docx', 'doc', 'jpg', 'zip', 'png', 'txt', 'jpeg', 'odt', 'xlsx', 'rtf', 'htm', 'xls', 'p7s', 'pptx',
'pages', 'rar', 'ppt', 'gif', 'tif', 'html', 'msg', 'asc', 'py', 'tiff', 'wps', 'bmp', '7z', 'c', 'csv', 'h',
'ics', 'vcf', 'cpp', 'dat', 'dotx', 'mp4', 'numbers', 'eps', 'gdoc', 'gz', 'java', 'key', 'mov',
'mp3', 'ods', 'otf', 'odp', 'odg', 'r', 'ra', 'rtfd', 'textclipping', 'txz', 'webarchive', 'xml', 'xps', 'md'

filesize per document < 20M
total post size < 64M

documentn

Alternatively to an array (see above), documents can also be transferred individually numbered document1, document2, etc. with the absolute path to the document.

[file]
allowed extensions are 'pdf', 'docx', 'doc', 'jpg', 'zip', 'png', 'txt', 'jpeg', 'odt', 'xlsx', 'rtf', 'htm', 'xls', 'p7s', 'pptx',
'pages', 'rar', 'ppt', 'gif', 'tif', 'html', 'msg', 'asc', 'py', 'tiff', 'wps', 'bmp', '7z', 'c', 'csv', 'h',
'ics', 'vcf', 'cpp', 'dat', 'dotx', 'mp4', 'numbers', 'eps', 'gdoc', 'gz', 'java', 'key', 'mov',
'mp3', 'ods', 'otf', 'odp', 'odg', 'r', 'ra', 'rtfd', 'textclipping', 'txz', 'webarchive', 'xml', 'xps', 'md'

filesize per document < 20M
total post size < 64M

message

Initial message from the applicant

flags

Array of flags to attach to this application

[string]

yes

custom_attribute_{id}

Custom applicant attribute (see below)

string

yes

Custom applicant attributes that were created individually can also be passed.

You can find the unique parameter names of these attributes in your Personio account under https://mycompany.personio.de/configuration/recruiting/applicants

Example of a custom applicant attribute with the unique name `custom_attribute_69`

Example of a custom applicant attribute with the unique name custom_attribute_69


What's Next

Embed an HTML form for applications into your jobsite

HTML form for Applications

Passing applications to Personio

Description of the applicant endpoint of the Personio Recruiting API