ConnectCloud Developers

The mail conversation with the applicant

GET /api/hr/v1/recruiting/applications/{id}/messages

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

Mail sent from the recruiting mailbox and the applicant's answers to it (matched by the reply address, else by the sender's only open application).

Parameters

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

Responses

  • 200 Messages, oldest first (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of ApplicationMessage): Mails of the conversation
    • authorName (string): Display name of who sent the mail
    • authorRef (string): Who sent the mail (e-mail)
    • body (string): Markdown (out) or text (in); links of interview invitations are left out
    • createdAt (string (date-time)): When the mail was sent or received
    • deliveryDetail (string): Details of a failed delivery
    • deliveryState (string): Delivery state reported by comms (one of queued, sent, failed, received)
    • direction (string): out: sent to the applicant, in: received from them (one of out, in)
    • fromAddress (string): Sender address of a received mail
    • id (string (uuid)): Id of the mail
    • kind (string): What the mail is about (one of confirmation, rejection, message, interview, reply)
    • subject (string): Subject of the mail

Example 200 answer:

{
  "items": [
    {
      "body": "Guten Tag Herr Lindner,\n\nvielen Dank für Ihre Bewerbung. Wir melden uns in den nächsten Tagen bei Ihnen.",
      "createdAt": "2026-11-02T18:44:00Z",
      "deliveryState": "sent",
      "direction": "out",
      "id": "3c5e7a9c-1e3a-4c5e-8a7c-1e3a5c7e9a9c",
      "kind": "confirmation",
      "subject": "Ihre Bewerbung bei der Muster IT-Systemhaus GmbH"
    },
    {
      "authorName": "Tobias Hartl",
      "authorRef": "tobias.hartl@muster-it.example",
      "body": "Guten Tag Herr Lindner,\n\nkönnten Sie uns noch Ihr letztes Arbeitszeugnis schicken?",
      "createdAt": "2026-11-10T09:05:00Z",
      "deliveryState": "sent",
      "direction": "out",
      "id": "1a3c5e7a-9c1e-4a3c-9e5a-9c1e3a5c7e9b",
      "kind": "message",
      "subject": "Ihre Bewerbung – Unterlagen"
    },
    {
      "body": "Guten Tag Herr Hartl,\n\nanbei das Zeugnis.\n\nViele Grüße\nStefan Lindner",
      "createdAt": "2026-11-10T19:32:00Z",
      "deliveryState": "received",
      "direction": "in",
      "fromAddress": "stefan.lindner@mail.example",
      "id": "5e7a9c1e-3a5c-4e7a-8c9e-3a5c7e9a1c9d",
      "kind": "reply",
      "subject": "AW: Ihre Bewerbung – Unterlagen"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/messages' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI