HR: Create form
hr_create_formCreate an HR form (a questionnaire). 'kind' is a CLOSED vocabulary — candidate, intern_brief, mentor_review, interview_scorecard, exit, documents, other — and defaults to 'other'. There is no 'survey' value: inventing one is refused, which is the single most common way this call is lost. The form is created together with its first DRAFT version, because a form with no version can be neither edited nor published; the result reports that version as 'draft_version_id'. Nobody can be SENT it until the questions are added and the version is published with hr_publish_form_version — this call alone produces an empty, unsendable form. 'key' is a per-workspace unique slug used by integrations; leave it out and it is generated from the name (Cyrillic transliterated). A key already taken in this workspace is refused rather than silently suffixed. Requires confirmation. CONFIRMATION: this tool is PROPOSED, never performed directly. You get status='confirmation_required' with an action_id and a plan_token, and the write happens only after confirm_action.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "hr_create_form"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | ||
| kind | No | ||
| name | Yes | ||
| description | No |