ConnectCloud Developers

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 of full_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 person
  • description (string): Markdown
  • formTemplateId (string (uuid)): Id of the application form template
  • location (string): Place of work (max length 300)
  • orgUnitId (string (uuid)): Heads and deputies of the unit (and the units above it) review the posting
  • publishFrom (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 template
    • key (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 of text, 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 questions
      • label (string): Display text of the choice
      • value (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 range
  • salaryMin (integer (int64)): In the currency's main unit per period
  • salaryPeriod (string): Period the salary refers to (one of year, month, hour; default "year")
  • startDate (string (date)): Start date (YYYY-MM-DD), empty for none
  • version (integer): Version of the posting a change is based on
  • workplace (string): Where the work is done (one of onsite, 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 of full_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 person
  • description (string): Markdown
  • formTemplateId (string (uuid)): Id of the application form template
  • location (string): Place of work (max length 300)
  • orgUnitId (string (uuid)): Heads and deputies of the unit (and the units above it) review the posting
  • publishFrom (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 template
    • key (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 of text, 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 questions
      • label (string): Display text of the choice
      • value (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 range
  • salaryMin (integer (int64)): In the currency's main unit per period
  • salaryPeriod (string): Period the salary refers to (one of year, month, hour; default "year")
  • startDate (string (date)): Start date (YYYY-MM-DD), empty for none
  • version (integer): Version of the posting a change is based on
  • workplace (string): Where the work is done (one of onsite, hybrid, remote; default "onsite")
  • access (array of PostingAccessEntry): Only for managers of the posting
    • role (string, required): viewer reads; reviewer also notes, rates and sees interviews; manager moves, rejects, hires, mails, schedules and edits the posting (one of viewer, reviewer, manager)
    • subjectId (string (uuid), required): Id of the employee, group or org unit
    • subjectKind (string, required): Who is named: one employee, the members of a group or of an org unit (one of employee, group, org_unit)
    • includeSubunits (boolean): org_unit only: the members of the units below it too
    • subjectName (string, read-only): Name of the employee, group or org unit (filled on reads)
  • closedAt (string (date-time)): When the posting was closed
  • counts (object): Applications per phase
  • createdAt (string (date-time)): When the posting was created
  • createdBy (string): Who created the posting (e-mail of the caller)
  • id (string (uuid)): Id of the posting
  • number (integer): Number of the posting, unique in the tenant (careers site address)
  • publishedAt (string (date-time)): When the posting was last published
  • role (string): The caller's role on the posting (one of viewer, reviewer, manager)
  • status (string): State of the posting (one of draft, 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"}'

View as Markdown · Interactive reference · OpenAPI