---
title: "POST Timeclock terminal"
method: POST
path: "/timeclocks/terminal"
---

# POST Timeclock terminal

`POST /timeclocks/terminal`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/timeclocks/terminal`
- Auth: API key in query parameter `access_token`

/timeclocks/terminal
Permission level: 3

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string, required
  - `location` integer, required
  - `pref_userlist` integer: enum [1, 2, 3] -> 1: Show employees as select box; 2: Show as Gallery; 3: Show employees as search box;
  - `pref_login` integer: enum [0, 1] -> 1: Require Full Employee Login; 0: Not requires
  - `pref_webcam` integer: enum [0, 1] -> 1: Require Webcam; 0: Does not require Webcam
  - `pref_password` integer: enum [0, 1] -> 1: Require Password; 0: Does not require Password
  - `returnObject` integer: enum [0,1] -> 0: return message "Terminal created", 1: return created object

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `store` string
    - `location` string
    - `key` string
    - `name` string
    - `pref_login` unknown
    - `pref_userid` unknown
    - `pref_username` unknown
    - `pref_password` string
    - `pref_userlist` unknown
    - `pref_webcam` string
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/timeclocks/terminal/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
