ConnectCloud Developers

Complete a hire with the employee created from the application (managers of the posting)

POST /api/hr/v1/recruiting/applications/{id}/hire

Module: HR · operationId: hireApplicant · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)

Create the employee first (createEmployee). The application moves to the hired phase and its files join the employee's Personalakte in the DMS.

Parameters

Name In Type Required Description
id path string (uuid) yes

Request body

application/json (required)

  • employeeId (string (uuid), required): Id of the employee created from the application
  • stageId (string (uuid)): A stage of the hired phase (default the first)
  • version (integer): Version of the application the hire is based on

Example:

{
  "employeeId": "9c1e3a5c-7e9a-4c1e-9a5c-7e9a1c3e5a97",
  "stageId": "4e6a8c0e-2a4c-4e6a-8c0e-2a4c6e8a0c86",
  "version": 7
}

Responses

  • 200 The application (application/json)
  • 400 Error (application/json)
  • 403 Error (application/json)
  • 404 Error (application/json)
  • 409 Error (application/json)
  • 503 Error (application/json)

Fields of the 200 answer:

  • answers (object): Answers to the form questions by question key
  • closeReason (string): Reason given when it was closed
  • closedAt (string (date-time)): When it was rejected, withdrawn or hired
  • consentAt (string (date-time)): When the applicant gave the consent
  • consentVersion (integer): Version of the consent text the applicant accepted (0: none)
  • coverLetter (string): Cover letter text
  • createdAt (string (date-time)): When the application was created
  • deleteAfter (string (date-time)): When the application is deleted
  • email (string): Applicant's e-mail address
  • employeeId (string (uuid)): The employee created from it (hired)
  • files (array of ApplicationFile): Files of the application (single reads)
    • contentType (string): Media type of the file
    • createdAt (string (date-time)): When the file was added
    • documentId (string): Id of the document in DMS
    • fieldKey (string): Key of the form question the file answers (role answer)
    • fileName (string): File name
    • id (string (uuid)): Id of the file
    • role (string): What the file is (CV, attachment, answer to a file question, mail attachment) (one of cv, attachment, answer, mail)
    • scanStatus (string): Result of the malware scan; content is served only when CLEAN (one of PENDING, CLEAN, INFECTED, SKIPPED, FAILED)
    • sizeBytes (integer (int64)): Size in bytes
  • firstName (string): Applicant's first name
  • id (string (uuid)): Id of the application
  • lastName (string): Applicant's last name
  • nextInterview (string (date-time)): Start of the next interview, if any
  • number (integer): Number of the application, unique in the tenant
  • phase (string): Phase of the current stage (one of new, active, hired, rejected, withdrawn)
  • phone (string): Applicant's phone number
  • postingId (string (uuid)): Id of the posting applied to
  • postingTitle (string): Title of the posting
  • rating (object): Summary of the reviewers' ratings
    • average (number): Average score (1–5)
    • count (integer): Number of ratings
    • mine (integer): The caller's score (0 not rated)
  • role (string): The caller's role on the posting (one of viewer, reviewer, manager)
  • source (string): How the application arrived (one of manual, portal, api)
  • stageChangedAt (string (date-time)): When the application entered its current stage
  • stageId (string (uuid)): Id of the current pipeline stage
  • talentPoolUntil (string (date-time)): Kept in the talent pool until then (applicant agreed)
  • updatedAt (string (date-time)): When the application was last changed
  • version (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)

Example 200 answer:

{
  "answers": {
    "fruehester_start": "2027-01-01",
    "gehaltsvorstellung": 52000,
    "powershell": "grundlagen"
  },
  "consentAt": "2026-11-02T18:43:00Z",
  "consentVersion": 2,
  "coverLetter": "Ich bin Fachinformatiker für Systemintegration und möchte mich nach vier Jahren im Rechenzentrum stärker auf Cloud-Arbeitsplätze spezialisieren.",
  "createdAt": "2026-11-02T18:43:00Z",
  "deleteAfter": "2027-11-02T18:43:00Z",
  "email": "stefan.lindner@mail.example",
  "files": [
    {
      "contentType": "application/pdf",
      "createdAt": "2026-11-02T18:41:00Z",
      "documentId": "5c7e9a1c-3e5a-4c7e-9a9c-3e5a7c9e1a95",
      "fileName": "lebenslauf-stefan-lindner.pdf",
      "id": "3a5c7e9a-1c3e-4a5c-8e7a-1c3e5a7c9e94",
      "role": "cv",
      "scanStatus": "CLEAN",
      "sizeBytes": 248311
    }
  ],
  "firstName": "Stefan",
  "id": "1c3e5a7c-9e1a-4c3e-9a5c-9e1a3c5e7a89",
  "lastName": "Lindner",
  "nextInterview": "2026-11-24T09:00:00Z",
  "number": 3,
  "phase": "active",
  "phone": "+49 170 55501003",
  "postingId": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
  "postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
  "rating": {
    "average": 3.5,
    "count": 2,
    "mine": 3
  },
  "role": "manager",
  "source": "portal",
  "stageChangedAt": "2026-11-12T10:30:00Z",
  "stageId": "0a2c4e6a-8c0e-4a2c-8e6a-8c0e2a4c6e84",
  "updatedAt": "2026-11-12T10:30:00Z",
  "version": 5
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/hire' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"employeeId":"9c1e3a5c-7e9a-4c1e-9a5c-7e9a1c3e5a97","stageId":"4e6a8c0e-2a4c-4e6a-8c0e-2a4c6e8a0c86","version":7}'

View as Markdown · Interactive reference · OpenAPI