## 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.<key> 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:

```json
{
  "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:

```json
{
  "status": "pending"
}
```

### Example request

```bash
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":""}'
```
