Invoice

Add an invoice

Changed on Aug 20, 2026

post/v1/workspaces/{workspaceId}/invoices

Request

Base URL: https://api.clockify.me/api
URL: https://api.clockify.me/api/v1/workspaces/{workspaceId}/invoices
Auth: one of:
- API key in header x-api-key
- API key in header x-addon-token

Path parameters

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

Request body

clientIdstring required

Represents a client identifier across the system.

currencystring required

Represents the currency used by the invoice.

dueDatestring date-time required

Represents an invoice due date in yyyy-MM-ddThh:mm:ssZ format.

issuedDatestring date-time required

Represents an invoice issued date in yyyy-MM-ddThh:mm:ssZ format.

numberstring required

Represents an invoice number.

timeViewMode'TIME_SENSITIVE_VIEW' | 'AGGREGATED_TIME_VIEW'

Example request

{
  "clientId": "98h687e29ae1f428e7ebe707",
  "currency": "USD",
  "dueDate": "2020-06-01T08:00:00Z",
  "issuedDate": "2020-01-01T08:00:00Z",
  "number": "202306121129"
}

Response

Created

billFromstring

Represents to whom the invoice should be billed from.

clientIdstring

Represents client identifier across the system.

currencystring

Represents the currency used by the invoice.

dueDatestring date-time

Represents an invoice due date in yyyy-MM-ddThh:mm:ssZ format.

idstring

Represents invoice identifier across the system.

issuedDatestring date-time

Represents an invoice issued date in yyyy-MM-ddThh:mm:ssZ format.

numberstring

Represents an invoice number.

Example response

{
  "billFrom": "Business X",
  "clientId": "34p687e29ae1f428e7ebe562",
  "currency": "USD",
  "dueDate": "2020-06-01T08:00:00Z",
  "id": "78a687e29ae1f428e7ebe303",
  "issuedDate": "2020-01-01T08:00:00Z",
  "number": "202306121129"
}

Changes

Aug 20, 2026a5b636acbcd8 Revision changes
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status

Operation history