---
title: "Add an invoice"
method: POST
path: "/v1/workspaces/{workspaceId}/invoices"
tags: ["Invoice"]
---

# Add an invoice

`POST /v1/workspaces/{workspaceId}/invoices`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- CreateInvoiceRequest
  - `clientId` string, required — Represents a client identifier across the system.
  - `currency` string, required — Represents the currency used by the invoice.
  - `dueDate` string, date-time, required — Represents an invoice due date in yyyy-MM-ddThh:mm:ssZ format.
  - `issuedDate` string, date-time, required — Represents an invoice issued date in yyyy-MM-ddThh:mm:ssZ format.
  - `number` string, required — Represents an invoice number.
  - `timeViewMode` 'TIME_SENSITIVE_VIEW' | 'AGGREGATED_TIME_VIEW'

## Response `201`

Created

- CreateInvoiceDtoV1
  - `billFrom` string — Represents to whom the invoice should be billed from.
  - `clientId` string — Represents client identifier across the system.
  - `currency` string — Represents the currency used by the invoice.
  - `dueDate` string, date-time — Represents an invoice due date in yyyy-MM-ddThh:mm:ssZ format.
  - `id` string — Represents invoice identifier across the system.
  - `issuedDate` string, date-time — Represents an invoice issued date in yyyy-MM-ddThh:mm:ssZ format.
  - `number` string — Represents an invoice number.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)