Allows you to create applications in Personio.

POST body example

{
  "job_position_id": 123,
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]",
  "recruiting_channel_id": 250624,
  "external_posting_id": "4821b24c-8d85-11ec-b909-0242ac120002",
  "message": "new applicant message",
  "application_date": "2022-02-17",
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ]
  "phase": {
    "type": "custom", // OR "system"
    "id": 26485 // if "tpye" is "system", then "id" is a string, e.g.: "offer"
  },
  "files": [
    {
      "uuid": "7d0f360a-8da3-11ec-b909-0242ac120002",
      "original_filename": "My CV.pdf",
      "category": "cv"
    },
    {
      "uuid": "f4cc2da0-8da4-11ec-b909-0242ac120002",
      "original_filename": "code challenge.zip",
      "category": "work-sample"
    }
  ],
  "attributes": [
    {
      "id": "birthday",
      "value": "1989-12-17"
    },
    {
      "id": "gender",
      "value": "male"
    },
    {
      "id": "location",
      "value": "Munich"
    },
    {
      "id": "phone",
      "value": "000111222333"
    },
    {
      "id": "available_from",
      "value": "As soon as possible"
    },
    {
      "id": "salary_expectations",
      "value": "40k"
    },
    {
      "id": "custom_attribute_1",
      "value": "attribute value"
    },
    {
      "id": "custom_attribute_2",
      "value": "custom_option_7"
    },
    {
      "id": "custom_attribute_3",
      "value": "2017-12-07"
    }
  ]
}

Error Codes

codeMeaning
errors.attribute-validation.unknownThe supplied attribute was not found in our system.
errors.attribute-validation.required-attributeA required attribute was missing, null or blank.
errors.attribute-validation.invalid-date-formatThe supplied date attribute did not match the "ISO-8601 Local Date" format.
errors.attribute-validation.invalid-email-formatThe supplied email seems not to be valid.
errors.attribute-validation.invalid-typeThe supplied attribute type is not supported.
errors.attribute-validation.unknown-attribute-optionThe attribute value is not in the provided options.
errors.date-validation.date-in-the-futureInvalid application date.
errors.phase-validation.invalid-system-phaseThe supplied application phase is not supported.
errors.file-validation.file-not-existsThe supplied reference could not be resolved.
errors.invalid-file-typeThe supplied file is of an unsupported format.
errors.file-too-bigThe file size exceeded the configured limit
errors.applicant-already-existsWe could not verify that this email has not yet applied to this position.
errors.posting-validation.posting-not-foundThe job posting could not be found or did not match the supplied channel.
errors.posting-validation.channel-not-foundThe recruiting channel could not be found.
feature.recruiting.disabledYour company does not have access to Personio's recruiting features.
feature.public-api.disabledYour company does not have access to Personio's recruiting API.
Language
Authorization
Bearer
Click Try It! to start a request and see the response here!