Create a draft posting (hr:recruiting:manage)
POST /api/hr/v1/recruiting/postings
Module: HR · operationId: createJobPosting · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)
Request body
application/json (required)
employmentType(string, required): Kind of employment (one offull_time,part_time,mini_job,apprenticeship,internship,working_student,freelance)title(string, required): Title of the posting (max length 300)contactEmployeeId(string (uuid)): Employee id of the contact persondescription(string): MarkdownformTemplateId(string (uuid)): Id of the application form templatelocation(string): Place of work (max length 300)orgUnitId(string (uuid)): Heads and deputies of the unit (and the units above it) review the postingpublishFrom(string (date-time)): A published posting is shown on the careers site from then on (empty: at once)publishUntil(string (date-time)): A published posting is shown on the careers site until then (empty: until closed)questions(array of ApplicationFormField): Questions of this posting after those of its form templatekey(string, required): Lower-case letters, digits, - or _; not a core field (first_name, last_name, email, phone, cover_letter, cv, attachments)kind(string, required): Kind of answer (one oftext,longtext,number,date,bool,select,multiselect,url,file)label(string, required): Question text (max length 300)help(string): Help text shown with the question (max length 1000)options(array of object): Choices of select and multiselect questionslabel(string): Display text of the choicevalue(string): Stored value of the choice
required(boolean): An answer is required
salaryCurrency(string): Currency of the salary (ISO 4217) (default"EUR")salaryMax(integer (int64)): Upper end of the salary rangesalaryMin(integer (int64)): In the currency's main unit per periodsalaryPeriod(string): Period the salary refers to (one ofyear,month,hour; default"year")startDate(string (date)): Start date (YYYY-MM-DD), empty for noneversion(integer): Version of the posting a change is based onworkplace(string): Where the work is done (one ofonsite,hybrid,remote; default"onsite")
Example:
{
"contactEmployeeId": "9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e",
"description": "## Ihre Aufgaben\n- Betrieb und Weiterentwicklung der Microsoft-365-Umgebungen unserer Kunden (Exchange Online, Teams, SharePoint, Intune)\n- Migrationen von On-Premises-Servern in die Cloud",
"employmentType": "full_time",
"formTemplateId": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
"location": "Regensburg",
"orgUnitId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
"questions": [
{
"key": "powershell",
"kind": "select",
"label": "Wie schätzen Sie Ihre PowerShell-Kenntnisse ein?",
"options": [
{
"label": "Grundlagen",
"value": "grundlagen"
},
{
"label": "Fortgeschritten",
"value": "fortgeschritten"
},
{
"label": "Experte",
"value": "experte"
}
],
"required": false
}
],
"salaryCurrency": "EUR",
"salaryMax": 58000,
"salaryMin": 48000,
"salaryPeriod": "year",
"startDate": "2027-01-01",
"title": "Systemadministrator:in (m/w/d) Microsoft 365",
"workplace": "hybrid"
}
Responses
- 201 Created (
application/json) - 400 Error (
application/json) - 403 Error (
application/json)
Fields of the 201 answer:
employmentType(string, required): Kind of employment (one offull_time,part_time,mini_job,apprenticeship,internship,working_student,freelance)title(string, required): Title of the posting (max length 300)contactEmployeeId(string (uuid)): Employee id of the contact persondescription(string): MarkdownformTemplateId(string (uuid)): Id of the application form templatelocation(string): Place of work (max length 300)orgUnitId(string (uuid)): Heads and deputies of the unit (and the units above it) review the postingpublishFrom(string (date-time)): A published posting is shown on the careers site from then on (empty: at once)publishUntil(string (date-time)): A published posting is shown on the careers site until then (empty: until closed)questions(array of ApplicationFormField): Questions of this posting after those of its form templatekey(string, required): Lower-case letters, digits, - or _; not a core field (first_name, last_name, email, phone, cover_letter, cv, attachments)kind(string, required): Kind of answer (one oftext,longtext,number,date,bool,select,multiselect,url,file)label(string, required): Question text (max length 300)help(string): Help text shown with the question (max length 1000)options(array of object): Choices of select and multiselect questionslabel(string): Display text of the choicevalue(string): Stored value of the choice
required(boolean): An answer is required
salaryCurrency(string): Currency of the salary (ISO 4217) (default"EUR")salaryMax(integer (int64)): Upper end of the salary rangesalaryMin(integer (int64)): In the currency's main unit per periodsalaryPeriod(string): Period the salary refers to (one ofyear,month,hour; default"year")startDate(string (date)): Start date (YYYY-MM-DD), empty for noneversion(integer): Version of the posting a change is based onworkplace(string): Where the work is done (one ofonsite,hybrid,remote; default"onsite")access(array of PostingAccessEntry): Only for managers of the postingrole(string, required): viewer reads; reviewer also notes, rates and sees interviews; manager moves, rejects, hires, mails, schedules and edits the posting (one ofviewer,reviewer,manager)subjectId(string (uuid), required): Id of the employee, group or org unitsubjectKind(string, required): Who is named: one employee, the members of a group or of an org unit (one ofemployee,group,org_unit)includeSubunits(boolean): org_unit only: the members of the units below it toosubjectName(string, read-only): Name of the employee, group or org unit (filled on reads)
closedAt(string (date-time)): When the posting was closedcounts(object): Applications per phasecreatedAt(string (date-time)): When the posting was createdcreatedBy(string): Who created the posting (e-mail of the caller)id(string (uuid)): Id of the postingnumber(integer): Number of the posting, unique in the tenant (careers site address)publishedAt(string (date-time)): When the posting was last publishedrole(string): The caller's role on the posting (one ofviewer,reviewer,manager)status(string): State of the posting (one ofdraft,published,closed,archived)updatedAt(string (date-time)): When the posting was last changed
Example 201 answer:
{
"access": [
{
"role": "reviewer",
"subjectId": "f2a4c6e8-0b2d-4f4a-8c6e-8a0c2e4b6d1c",
"subjectKind": "employee",
"subjectName": "Jonas Bauer"
},
{
"includeSubunits": true,
"role": "viewer",
"subjectId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
"subjectKind": "org_unit",
"subjectName": "Technik"
}
],
"contactEmployeeId": "9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e",
"counts": {
"active": 3,
"hired": 0,
"new": 1,
"rejected": 0,
"withdrawn": 0
},
"createdAt": "2026-09-29T14:10:00Z",
"createdBy": "tobias.hartl@muster-it.example",
"description": "## Ihre Aufgaben\n- Betrieb und Weiterentwicklung der Microsoft-365-Umgebungen unserer Kunden (Exchange Online, Teams, SharePoint, Intune)\n- Migrationen von On-Premises-Servern in die Cloud",
"employmentType": "full_time",
"formTemplateId": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
"id": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
"location": "Regensburg",
"number": 1,
"orgUnitId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
"publishedAt": "2026-10-01T07:00:00Z",
"questions": [],
"role": "manager",
"salaryCurrency": "EUR",
"salaryMax": 58000,
"salaryMin": 48000,
"salaryPeriod": "year",
"startDate": "2027-01-01",
"status": "published",
"title": "Systemadministrator:in (m/w/d) Microsoft 365",
"updatedAt": "2026-10-01T07:00:00Z",
"version": 3,
"workplace": "hybrid"
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/recruiting/postings' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"contactEmployeeId":"9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e","description":"## Ihre Aufgaben\n- Betrieb und Weiterentwicklung der Microsoft-365-Umgebungen unserer Kunden (Exchange Online, Teams, SharePoint, Intune)\n- Migrationen von On-Premises-Servern in die Cloud","employmentType":"full_time","formTemplateId":"3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90","location":"Regensburg","orgUnitId":"2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72","questions":[{"key":"powershell","kind":"select","label":"Wie schätzen Sie Ihre PowerShell-Kenntnisse ein?","options":[{"label":"Grundlagen","value":"grundlagen"},{"label":"Fortgeschritten","value":"fortgeschritten"},{"label":"Experte","value":"experte"}],"required":false}],"salaryCurrency":"EUR","salaryMax":58000,"salaryMin":48000,"salaryPeriod":"year","startDate":"2027-01-01","title":"Systemadministrator:in (m/w/d) Microsoft 365","workplace":"hybrid"}'