---
title: "Create an invoice · Invoices · Practice Manager API · COUNT Partner API"
description: "Creates an invoice, estimate, or credit memo (invoiceType: \"memo\"). POST /firm-partners/workspace/invoices"
canonical: "https://developers.getcount.com/practice-manager/reference/invoices/create-invoice"
source: "https://developers.getcount.com/practice-manager/reference/invoices/create-invoice"
---
[Invoices](https://developers.getcount.com/practice-manager/reference/invoices) / Create an invoice

# Create an invoice

POST `/firm-partners/workspace/invoices`

Creates an invoice, estimate, or credit memo (invoiceType: "memo").

Required: exactly one of customerUuid OR inline customer object, date, invoiceNumber, dueDate (invoices and estimates), and products[] with productUuid, an inline product, or categoryAccountUuid for a free-text line. Optional isDraft (false posts revenue journals for migrations). Response may include _partnerInlineCreated, and `_partnerWarnings: [{ field, reason, message }]` for any field that was ignored.

Some fields work differently in US and NZ workspaces

Showing US sales tax and NZ GST rules.

HMAC signature only

[Credit Memos API](https://developers.getcount.com/practice-manager/reference/credit-memo) [Customers API](https://developers.getcount.com/practice-manager/reference/customers) [Products & Services API](https://developers.getcount.com/practice-manager/reference/products-and-services) [Transactions API](https://developers.getcount.com/practice-manager/reference/transactions)

#### Headers

`count-workspace-id` uuid required

UUID of the client workspace to act on. It must be one of your firm's client workspaces (or the firm's own workspace) and within the API key's client workspaces.

#### Request body

`customerUuid` uuid

Existing customer UUID. Mutually exclusive with customer.

`customer` object

Inline customer when customerUuid is omitted.

`customer` string required

Customer display name.

`invoiceType` enum

Document type. Defaults to invoice.

One of: `invoice`, `estimate`, `memo`

`date` date required

Invoice date (ISO).

`dueDate` date

Due date (ISO). Required for invoices and estimates, drafts included; only credit memos may omit it.

`currency` string

ISO 4217 currency code.

`bookingExchangeRate` number

Your own rate from the document currency to the workspace currency. Only used together with `exchangeRateSource: "user"`; otherwise COUNT looks up the rate itself.

`exchangeRateSource` string

Send `user` with `bookingExchangeRate` to fix the rate. On update, `null` goes back to the rate COUNT looks up for the document date.

`tagUuids` array

Tag UUIDs from the Tags API for the whole invoice. Invoice lines do not take their own tags.

`invoiceNumber` string required

Invoice number shown to the customer.

`products` array required

The products or services billed on this invoice.

`productUuid` uuid

Product UUID from list_products. `uuid` is accepted as an alias. Omit it for a free-text line.

`categoryAccountUuid` uuid

Income account UUID from the Chart of Accounts. Required on a free-text line; on a product line it overrides the product's income account.

`name` string

Item name on a free-text line.

`description` string

Line description.

`quantity` number required

Quantity billed.

`unitPrice` number required

Price per unit.

`taxes` array

Tax code UUIDs from List tax codes. Omit it and the line takes the product's tax codes; send `[]` for a line with no tax. A free-text line takes only the codes it names.

- US· Sales tax The sales tax codes to charge on the line.
- NZ· GST The line's GST code: `15% GST on Income` for a standard-rated sale, `Zero Rated` for a zero-rated supply, or `No GST` for a sale outside GST. An Income account takes `15% GST on Income` or `Zero Rated`, never `15% GST on Expenses`.

`nonTaxable` boolean

Raise the line without charging tax.

- US· Sales tax The line keeps its tax code, charges no tax, and reports as a Non-Taxable sale under that code.
- NZ· GST Clears the line's tax codes, the same as `taxes: []`. It does not zero-rate the line; send the `Zero Rated` code in `taxes` for that.

`customerExemptionOverridden` boolean

Charge tax on this line even though the customer is tax-exempt (`taxExcluded`).

- US· Sales tax Without it, a tax-exempt customer's taxed lines are raised Non-Taxable.
- NZ· GST Ignored. Every line for a tax-exempt customer is raised with no tax.

`productsPriceType` enum

How every line's `unitPrice` is read against its tax codes. `tax-exclusive` (the workspace default when omitted) adds the tax on top of `unitPrice`; `tax-inclusive` treats `unitPrice` as already containing it. A credit memo must repeat the original invoice's setting or it credits a different net amount. For a document with no tax, send `taxes: []` on each line.

One of: `tax-exclusive`, `tax-inclusive`

`appliedToInvoiceUuid` uuid

For credit memos: link to an open invoice at create time.

`isDraft` boolean

When false, approves and posts revenue journals immediately (migration use case). Defaults to draft.

#### Responses

`201` Invoice created successfully.

`400` Bad request — validation failed, a missing due date on an invoice or estimate, or a free-text line with no categoryAccountUuid.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The key is inactive or its scope does not allow this request, the workspace is not managed by your firm or is outside the key's client workspaces, the workspace has no active subscription, or it is portal-only and the route needs bookkeeping. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` Customer or product not found.

`409` The workspace has no Custom line product, so free-text lines cannot be raised.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Previous GET Get the next invoice number](https://developers.getcount.com/practice-manager/reference/invoices/get-next-invoice-number) [Next PATCH Update an invoice](https://developers.getcount.com/practice-manager/reference/invoices/update-invoice)

POST `https://api.getcount.com/firm-partners/workspace/invoices`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'POST';
const signingPath = '/workspace/invoices';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "customerUuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
  "invoiceType": "invoice",
  "invoiceNumber": "INV-1042",
  "date": "2026-03-01",
  "dueDate": "2026-03-31",
  "currency": "USD",
  "products": [
    {
      "productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
      "description": "Consulting services",
      "quantity": 10,
      "unitPrice": 100,
      "nonTaxable": false
    },
    {
      "categoryAccountUuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "name": "Site visit",
      "description": "Travel to client office",
      "quantity": 1,
      "unitPrice": 150
    }
  ]
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/workspace/invoices`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    'count-workspace-id': '5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716',
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 201

```json
{
  "status": "success",
  "data": {
    "invoice": {
      "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
      "invoiceNumber": "INV-1042",
      "invoiceType": "invoice",
      "customerUuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
      "date": "2026-03-01",
      "dueDate": "2026-03-31",
      "currency": "USD",
      "status": "draft",
      "isDraft": true,
      "approved": false,
      "isSent": false,
      "paymentStatus": "unpaid",
      "subtotal": 1000,
      "taxTotal": 85,
      "total": 1085,
      "amountDue": 1085,
      "products": [
        {
          "productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
          "description": "Consulting services",
          "quantity": 10,
          "unitPrice": 100,
          "nonTaxable": false
        }
      ],
      "createdAt": "2026-03-01T09:00:00.000Z",
      "updatedAt": "2026-03-02T11:15:00.000Z"
    }
  }
}
```
