Create an hour entry (scope hours:write)

POST/api/v1/hours

Authorization

AuthorizationBearer token · headerrequired

Scoped API token (bnx_…). Required scopes are noted per operation.

Request body

application/json

matterIdstringrequired

min length 1

datestringrequired

min length 1

workedHoursnumberrequired

min 0

billableHoursnumber

min 0

descriptionstringrequired

min length 1

timeClassstring

Allowed:billableinternalnon_billable

activityCodestring

writeOffReasonstring

acknowledgeBillableOverWorkedboolean

Responses

201

Created resource

idstringrequired

matterIdstring | nullrequired

employeeUserIdstringrequired

datestringrequired

workedHoursnumberrequired

billableHoursnumberrequired

timeClassstringrequired

activityCodestring | nullrequired

timekeepingGroupstring | nullrequired

descriptionstringrequired

rateCentsinteger | nullrequired

rateSourcestring | nullrequired

rateResolutionReasonstring | nullrequired

invoiceIdstring | nullrequired

billableOverWorkedConfirmedbooleanrequired

createdAtstringrequired

updatedAtstringrequired

400

Invalid request

errorstringrequired

codestringrequired

rulestring

401

Unauthenticated

errorstringrequired

codestringrequired

rulestring

403

Forbidden (missing scope or permission)

errorstringrequired

codestringrequired

rulestring

429

Rate limited

errorstringrequired

codestringrequired

rulestring

Request

curl -X POST '/api/v1/hours' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "matterId": "string",
  "date": "string",
  "workedHours": 0,
  "billableHours": 0,
  "description": "string",
  "timeClass": "billable",
  "activityCode": "string",
  "writeOffReason": "string",
  "acknowledgeBillableOverWorked": true
}'

const response = await fetch("/api/v1/hours", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"matterId\": \"string\",\n  \"date\": \"string\",\n  \"workedHours\": 0,\n  \"billableHours\": 0,\n  \"description\": \"string\",\n  \"timeClass\": \"billable\",\n  \"activityCode\": \"string\",\n  \"writeOffReason\": \"string\",\n  \"acknowledgeBillableOverWorked\": true\n}"
});

import requests

response = requests.post(
    "/api/v1/hours",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"matterId\": \"string\",\n  \"date\": \"string\",\n  \"workedHours\": 0,\n  \"billableHours\": 0,\n  \"description\": \"string\",\n  \"timeClass\": \"billable\",\n  \"activityCode\": \"string\",\n  \"writeOffReason\": \"string\",\n  \"acknowledgeBillableOverWorked\": true\n}",
)

Response

{
  "id": "string",
  "matterId": "string",
  "employeeUserId": "string",
  "date": "string",
  "workedHours": 0,
  "billableHours": 0,
  "timeClass": "string",
  "activityCode": "string",
  "timekeepingGroup": "string",
  "description": "string",
  "rateCents": 0,
  "rateSource": "string",
  "rateResolutionReason": "string",
  "invoiceId": "string",
  "billableOverWorkedConfirmed": true,
  "createdAt": "string",
  "updatedAt": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}