Create a shift
Add a shift for an employee in a unit or section.
MCP tool quinyx_write → create_shift
write Confirm
Saves one shift like the Add shift panel. Quinyx scheduling warnings apply: an overridable warning is returned in the response, and a hard stop for a severe compliance breach fails the call with the rule that stopped it. The employee sees the shift once the period is published. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee id from list_employees. Passive employees are rejected. |
| group_id string required | string | Unit or section id from list_groups. |
| shift_type string required | string | Name of a shift type your account has. |
| start string required | string | Start, YYYY-MM-DDTHH:MM. |
| end string required | string | End, YYYY-MM-DDTHH:MM. |
| comment string | string | Optional comment on the shift. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "quinyx_write",
"arguments": {
"operation": "create_shift",
"arguments": {
"employee_id": "employee_8c41d2",
"group_id": "group_8c41d2",
"shift_type": "shift type",
"start": "start",
"end": "end"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"shift_id": "90601",
"employee": "Tom Becker",
"shift_type": "Closing",
"start": "2026-10-29T14:00",
"end": "2026-10-29T22:00",
"warnings": []
},
"isError": false
}