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": [
  "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",
      "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

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. 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. 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.
Click Try It! to start a request and see the response here!