---
title: "Clock in to a manual break"
method: POST
path: "/time-clock/v1/time-clocks/{timeClockId}/manual-breaks/{manualBreakId}/clock-in"
tags: ["Time Clock:v1:TimeClocks:TimeClock:ManualBreaks:ManualBreakClockIn"]
---

# Clock in to a manual break

`POST /time-clock/v1/time-clocks/{timeClockId}/manual-breaks/{manualBreakId}/clock-in`

Start a manual break for an employee. If the employee is clocked into a shift on the same time clock, the shift is automatically closed and the break is started in one call (attributed to the shift's job). If the employee is idle, the break starts standalone. Pass an optional timestamp to record a break that started earlier (offline sync).

## Path parameters

- `manualBreakId` string, required — The unique identifier of the manual break to start
- `timeClockId` integer, required — The unique identifier of the time clock

## Request body

- ManualBreakClockInRequest
  - `userId` integer, required — The unique identifier of the user. Make sure the user is assigned to the specified time clock.
  - `timezone` string — The timezone in Tz format (e.g. America/New_York). If not specified, the time clock's configured timezone is used.
  - `timestamp` integer — The break-start time in Unix format (in seconds). If omitted, the server captures the time when the request is received. Must be no more than 12 hours in the past and not in the future. Use to record a break that already started - typically when a physical clock device is flushing queued punches after recovering from offline mode.
  - `locationData` GpsData
    - `address` string — The address associated with the GPS data.
    - `longitude` number — The longitude coordinate.
    - `latitude` number — The latitude coordinate.

## Response `200`

Successful Response

- APIResponseManualBreakClockInResponse
  - `requestId` string
  - `data` ManualBreakClockInResponse, required
    - `id` string, required — The unique identifier of the break activity that was started
    - `start` TimeActivityTimePointResponse, required
      - `timestamp` integer, required — The timestamp in Unix format (in seconds)
      - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
      - `locationData` GpsData
        - `address` string — The address associated with the GPS data.
        - `longitude` number — The longitude coordinate.
        - `latitude` number — The latitude coordinate.
      - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
      - `source` PunchSourceResponse
        - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
        - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
        - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
        - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
    - `isSwitchFromShift` boolean, required — true if an open shift was automatically closed to start this break; false if the employee was idle
    - `closedShift` V2FeaturesPunchclockExternalApiV1TimeClocksModelsShiftResponseShiftResponse
      - `id` string, required — The unique identifier of the time clock
      - `managerNote` string — The manager note providing additional details
      - `employeeNote` string — The employee note providing additional details
      - `start` TimeActivityTimePointResponse, required
        - `timestamp` integer, required — The timestamp in Unix format (in seconds)
        - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `locationData` GpsData
          - `address` string — The address associated with the GPS data.
          - `longitude` number — The longitude coordinate.
          - `latitude` number — The latitude coordinate.
        - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
        - `source` PunchSourceResponse
          - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
          - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
          - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
          - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
      - `end` TimeActivityTimePointResponse
        - `timestamp` integer, required — The timestamp in Unix format (in seconds)
        - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `locationData` GpsData
          - `address` string — The address associated with the GPS data.
          - `longitude` number — The longitude coordinate.
          - `latitude` number — The latitude coordinate.
        - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
        - `source` PunchSourceResponse
          - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
          - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
          - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
          - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
      - `createdAt` integer — The creation time of the time activity
      - `modifiedAt` integer — The last modification time of the time activity
      - `userId` integer, required — The unique identifier of the user. Make sure the user is assigned to the specified time clock.
      - `jobId` string — The unique identifier of the associated job or sub-job. Make sure the job is assigned to the specified time clock.
      - `schedulerShiftId` string — The scheduled shift from the schedule associated with the clocking in event

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)