---
title: "POST /timeRecord"
method: POST
path: "/timeRecord"
tags: ["timeRecord"]
---

# POST /timeRecord

`POST /timeRecord`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/timeRecord`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/timeRecord/post.ts> (a function with typed inputs; its response is checked against the schema)

create a timeRecord

## Query parameters

- `dryRun` boolean

## Request body

- TimeRecord
  - `id` string
  - `version` string
  - `articleId` string
  - `billable` boolean
  - `billableDurationSeconds` integer
  - `billableInvoiceStatus` 'INVOICED' | 'NOT_INVOICED' | 'PARTLY_INVOICED'
  - `createdDate` integer
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `customerId` string
  - `description` string
  - `durationSeconds` integer, required
  - `externalConnectionSourceId` string
  - `hourlyRate` string, number
  - `lastModifiedDate` integer
  - `performanceRecordedStatus` 'NOT_PERFORMANCE_RECORDABLE' | 'ON_PERFORMANCE_RECORD' | 'PERFORMANCE_RECORDABLE' | 'PERFORMANCE_RECORDED'
  - `placeOfServiceId` string
  - `printOnPerformanceRecord` boolean
  - `projectId` string
  - `projectTaskId` string
  - `salesInvoiceId` string
  - `salesOrderId` string
  - `salesOrderTicketId` string
  - `serviceQuotaId` string
  - `startDate` integer, required
  - `taskId` string
  - `ticketId` string
  - `timeRecordSource` 'TEAMVIEWER'
  - `userId` string

## Response `201`

timeRecord create response

- TimeRecord
  - `id` string
  - `version` string
  - `articleId` string
  - `billable` boolean
  - `billableDurationSeconds` integer
  - `billableInvoiceStatus` 'INVOICED' | 'NOT_INVOICED' | 'PARTLY_INVOICED'
  - `createdDate` integer
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `customerId` string
  - `description` string
  - `durationSeconds` integer, required
  - `externalConnectionSourceId` string
  - `hourlyRate` string, number
  - `lastModifiedDate` integer
  - `performanceRecordedStatus` 'NOT_PERFORMANCE_RECORDABLE' | 'ON_PERFORMANCE_RECORD' | 'PERFORMANCE_RECORDABLE' | 'PERFORMANCE_RECORDED'
  - `placeOfServiceId` string
  - `printOnPerformanceRecord` boolean
  - `projectId` string
  - `projectTaskId` string
  - `salesInvoiceId` string
  - `salesOrderId` string
  - `salesOrderTicketId` string
  - `serviceQuotaId` string
  - `startDate` integer, required
  - `taskId` string
  - `ticketId` string
  - `timeRecordSource` 'TEAMVIEWER'
  - `userId` string

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/timeRecord/post.md)

---

[API](https://skmtc.dev/weclapp/apis/weclapp-api.md) - [All operations](https://skmtc.dev/weclapp/apis/weclapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weclapp/apis/weclapp-api/revisions/0e021229755d?raw)