Actions39
- Absence Period Actions
- Absence Type Actions
- Attendance Period Actions
- Compensation Actions
- Document Actions
- Employment Actions
- Organization Actions
- Person Actions
- Project Actions
Attendance Period → Create
AI-generatedSummary
Create a Personio attendance period for an employee by sending a POST request to /v2/attendance-periods. Choose a work or break period and provide its start time; optionally include an end time, comment, or project ID.
Inputs
- Person ID (required) — Numeric ID of the employee.
- Type (required) — Attendance type: Work (
WORK, the default) or Break (BREAK). - Start Date/Time (required) — Local date and time in
YYYY-MM-DDTHH:MM:SSformat, without a timezone offset. - Additional Fields — Optionally set a comment (maximum 1000 characters), an end date/time in the same local format, or a project ID. Leave the end time empty for an ongoing period. Project IDs apply only to Work periods and the project must be active.
- Request Options — Optional request settings: batch input items (default 50 per batch, 1000 ms interval), accept invalid SSL certificates, use an HTTP proxy, or set the response-header timeout (default 10000 ms).
Output shape
A list of n8n items containing the API response.
The operation sends a create request. Its routing does not unwrap the response via
extractData, so the returned item shape follows the API response as handled by n8n. Each input item is sent as a request; batching can throttle requests.
Examples
Example 1: Create a completed work period
Supply the employee ID, select Work, set the local start date/time, then set the end date/time and optionally a comment or active project ID.
Example 2: Create an ongoing break period
Supply the employee ID, select Break, set the local start date/time, and leave End Date/Time empty.