---
title: "Creates a ClockEvent resource."
method: POST
path: "/clock_events"
tags: ["ClockEvent"]
---

# Creates a ClockEvent resource.

`POST /clock_events`

## Headers

- `x-auth-parim-timestamp` string, required
- `x-auth-parim-key` string, required
- `X-PARiM-Domain` string, required
- `x-auth-parim-nonce` string, required
- `x-auth-parim-signature` string, required

## Request body

- ClockEvent — A Clock Event Resource.
  - `id` integer — Clock event ID. Read-only.
  - `shift_id` integer — ID of the shift the clock event applies to.
  - `user_id` integer — User ID.
  - `action_by_user_id` integer — Created by User ID.
  - `type` 'clock_in' | 'clock_out' | 'break_start' | 'break_end' | 'check_in' | 'checkpoint_check_in' | 'location_check', required — Clock event type.
  - `time` string, date-time — Normalized value of clock event time. Read-only.
  - `latitude` number — User location latitude at time of clocking. Nullable.
  - `longitude` number — User location longitude at time of clocking. Nullable.
  - `accuracy` integer — Accuracy of user location in meters at time of clocking. Nullable.
  - `timestamp` integer — Normalized (exact time rounded to nearest quarter hour) value of clock event UNIX timestamp in seconds. . Read-only.
  - `exact_timestamp` integer — UNIX timestamp in seconds exact time the clock event takes/took place. Defaults to time of request. Nullable.
  - `device` string — Optional user device description or identifier. Nullable.

## Response `201`

ClockEvent resource created

- ClockEvent — A Clock Event Resource.
  - `id` integer — Clock event ID. Read-only.
  - `shift_id` integer — ID of the shift the clock event applies to.
  - `user_id` integer — User ID.
  - `action_by_user_id` integer — Created by User ID.
  - `type` 'clock_in' | 'clock_out' | 'break_start' | 'break_end' | 'check_in' | 'checkpoint_check_in' | 'location_check', required — Clock event type.
  - `time` string, date-time — Normalized value of clock event time. Read-only.
  - `latitude` number — User location latitude at time of clocking. Nullable.
  - `longitude` number — User location longitude at time of clocking. Nullable.
  - `accuracy` integer — Accuracy of user location in meters at time of clocking. Nullable.
  - `timestamp` integer — Normalized (exact time rounded to nearest quarter hour) value of clock event UNIX timestamp in seconds. . Read-only.
  - `exact_timestamp` integer — UNIX timestamp in seconds exact time the clock event takes/took place. Defaults to time of request. Nullable.
  - `device` string — Optional user device description or identifier. Nullable.

## Other responses

- `400` — Invalid request message or headers.
- `401` — Request not authorized.
- `404` — Resource not found
- `428` — A published shift must exist for the user at specified time, none found.
- `500` — 500 response

---

[API](https://skmtc.dev/parim/apis/clockingapi.md) · [All operations](https://skmtc.dev/parim/apis/clockingapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parim/clockingapi/revisions/c9518eb0d4c8/schema)