ConnectCloud Developers

Apply to an open posting (public)

POST /api/hr/v1/careers/{subdomain}/postings/{number}/applications

Module: HR · operationId: submitCareerApplication · Tag: Careers · Auth: none

Send JSON, or multipart/form-data with the part application (the same JSON) first and the files after it: cv, attachment and answer.<key> for file questions; at most 10 files of 10 MB (PDF, Word, OpenDocument, JPEG, PNG, HEIC), 101 MB in all. Files are checked for malware before anybody opens them. The answer is always 202 pending: the applicant receives a mail with a link that confirms the application within 24 hours; unconfirmed applications are deleted with their files. Errors only report what the applicant can fix. Limited to one request per 20 seconds per client (bursts up to 5) and to a few applications per address and day.

Parameters

Name In Type Required Description
subdomain path string yes The tenant's subdomain, the address of its careers page (case-insensitive)
number path integer yes

Request body

application/json (required)

  • altcha (string, required): The solved captcha (base64 payload of the ALTCHA widget)
  • consentVersion (integer, required): The version of the consent text the applicant accepted – the current one
  • email (string (email), required): Receives the confirmation link (max length 320)
  • firstName (string, required): Applicant's first name (max length 200)
  • lastName (string, required): Applicant's last name (max length 200)
  • answers (object): Answers by question key; required questions must be answered (file questions with an answer. part)
  • coverLetter (string): Cover letter text (max length 20000)
  • phone (string): Applicant's phone number (max length 100)
  • talentPool (boolean): Agrees to the talent pool
  • website (string): Honeypot – leave empty (filled in, the application is dropped silently)

Example:

{
  "altcha": "EXAMPLEeyJhbGdvcml0aG0iOiJTSEEtMjU2In0",
  "answers": {
    "fruehester_start": "2027-01-01",
    "zertifizierungen": [
      "ms_102",
      "md_102"
    ]
  },
  "consentVersion": 2,
  "coverLetter": "Als Consultant für Microsoft 365 habe ich zuletzt Tenant-zu-Tenant-Migrationen und Intune-Rollouts geleitet.",
  "email": "katharina.reiter@mail.example",
  "firstName": "Katharina",
  "lastName": "Reiter",
  "phone": "+49 160 55501002",
  "talentPool": true,
  "website": ""
}

Responses

  • 202 Accepted; a confirmation mail is on its way (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)
  • 413 Error (application/json)
  • 422 Error (application/json)
  • 429 Error (application/json)
  • 503 Error (application/json)

Fields of the 202 answer:

  • status (string): Always pending: the applicant confirms with the mailed link (one of pending)

Example 202 answer:

{
  "status": "pending"
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/hr/v1/careers/muster-gmbh/postings/1/applications' \
  -H 'Content-Type: application/json' \
  --data '{"altcha":"EXAMPLEeyJhbGdvcml0aG0iOiJTSEEtMjU2In0","answers":{"fruehester_start":"2027-01-01","zertifizierungen":["ms_102","md_102"]},"consentVersion":2,"coverLetter":"Als Consultant für Microsoft 365 habe ich zuletzt Tenant-zu-Tenant-Migrationen und Intune-Rollouts geleitet.","email":"katharina.reiter@mail.example","firstName":"Katharina","lastName":"Reiter","phone":"+49 160 55501002","talentPool":true,"website":""}'

View as Markdown · Interactive reference · OpenAPI