POST body example

{
  "job_position_id": 123,
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@email.com",
  "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

code	Meaning
errors.attribute-validation.unknown	The supplied attribute was not found in our system.
errors.attribute-validation.required-attribute	A required attribute was missing, null or blank.
errors.attribute-validation.invalid-date-format	The supplied date attribute did not match the "ISO-8601 Local Date" format.
errors.attribute-validation.invalid-email-format	The supplied email seems not to be valid.
errors.attribute-validation.invalid-type	The supplied attribute type is not supported.
errors.attribute-validation.unknown-attribute-option	The attribute value is not in the provided options.
errors.date-validation.date-in-the-future	Invalid application date.
errors.phase-validation.invalid-system-phase	The supplied application phase is not supported.
errors.file-validation.file-not-exists	The supplied reference could not be resolved.	errors.file-validation.unknown-file-category	The supplied document category is not supported.
errors.invalid-file-type	The supplied file is of an unsupported format.
errors.file-too-big	The file size exceeded the configured limit
errors.applicant-already-exists	We could not verify that this email has not yet applied to this position.
errors.posting-validation.posting-not-found	The job posting could not be found or did not match the supplied channel.
errors.posting-validation.channel-not-found	The recruiting channel could not be found.	errors.job-position.not-published	Job position for which the application is created is not published.
feature.recruiting.disabled	Your company does not have access to Personio's recruiting features.
feature.public-api.disabled	Your company does not have access to Personio's recruiting API.