Create an application form (hr:recruiting:manage)
POST /api/hr/v1/recruiting/form-templates
Module: HR · operationId: createApplicationForm · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)
Request body
application/json (required)
name(string, required): Name of the form (max length 200)archived(boolean): Archived: no longer offered for new data, kept for existing datacreatedAt(string (date-time), read-only): When the application form was createddescription(string): Description of the form (max length 2000)fields(array of ApplicationFormField): Questions of the form after the fixed fieldskey(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
id(string (uuid), read-only): Id of the application formupdatedAt(string (date-time), read-only): When the application form was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example:
{
"archived": false,
"createdAt": "2026-09-01T09:00:00Z",
"description": "Zusatzfragen für Stellen in Technik und Service Desk",
"fields": [
{
"key": "fruehester_start",
"kind": "date",
"label": "Ab wann können Sie bei uns starten?",
"required": true
},
{
"key": "gehaltsvorstellung",
"kind": "number",
"label": "Ihre Gehaltsvorstellung (brutto pro Jahr)",
"required": false
},
{
"key": "zertifizierungen",
"kind": "multiselect",
"label": "Welche Microsoft-Zertifizierungen haben Sie?",
"options": [
{
"label": "MS-102",
"value": "ms_102"
},
{
"label": "MD-102",
"value": "md_102"
},
{
"label": "AZ-104",
"value": "az_104"
}
],
"required": false
}
],
"id": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
"name": "Technische Stellen",
"updatedAt": "2026-09-15T13:20:00Z",
"version": 2
}
Responses
- 201 Created (
application/json) - 400 Error (
application/json)
Fields of the 201 answer:
name(string, required): Name of the form (max length 200)archived(boolean): Archived: no longer offered for new data, kept for existing datacreatedAt(string (date-time), read-only): When the application form was createddescription(string): Description of the form (max length 2000)fields(array of ApplicationFormField): Questions of the form after the fixed fieldskey(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
id(string (uuid), read-only): Id of the application formupdatedAt(string (date-time), read-only): When the application form was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example 201 answer:
{
"archived": false,
"createdAt": "2026-09-01T09:00:00Z",
"description": "Zusatzfragen für Stellen in Technik und Service Desk",
"fields": [
{
"key": "fruehester_start",
"kind": "date",
"label": "Ab wann können Sie bei uns starten?",
"required": true
},
{
"key": "gehaltsvorstellung",
"kind": "number",
"label": "Ihre Gehaltsvorstellung (brutto pro Jahr)",
"required": false
},
{
"key": "zertifizierungen",
"kind": "multiselect",
"label": "Welche Microsoft-Zertifizierungen haben Sie?",
"options": [
{
"label": "MS-102",
"value": "ms_102"
},
{
"label": "MD-102",
"value": "md_102"
},
{
"label": "AZ-104",
"value": "az_104"
}
],
"required": false
}
],
"id": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
"name": "Technische Stellen",
"updatedAt": "2026-09-15T13:20:00Z",
"version": 2
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/recruiting/form-templates' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"archived":false,"createdAt":"2026-09-01T09:00:00Z","description":"Zusatzfragen für Stellen in Technik und Service Desk","fields":[{"key":"fruehester_start","kind":"date","label":"Ab wann können Sie bei uns starten?","required":true},{"key":"gehaltsvorstellung","kind":"number","label":"Ihre Gehaltsvorstellung (brutto pro Jahr)","required":false},{"key":"zertifizierungen","kind":"multiselect","label":"Welche Microsoft-Zertifizierungen haben Sie?","options":[{"label":"MS-102","value":"ms_102"},{"label":"MD-102","value":"md_102"},{"label":"AZ-104","value":"az_104"}],"required":false}],"id":"3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90","name":"Technische Stellen","updatedAt":"2026-09-15T13:20:00Z","version":2}'