---
title: "Create a recurring invoice template · Recurring Invoice Templates · Practice Manager API · COUNT Partner API"
description: "Creates a draft invoice plus a recurring template with the supplied schedule. POST /firm-partners/workspace/recurring-invoice-templates"
canonical: "https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/create-recurring-invoice-template"
source: "https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/create-recurring-invoice-template"
---
[Recurring Invoice Templates](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates) / Create a recurring invoice template

# Create a recurring invoice template

POST `/firm-partners/workspace/recurring-invoice-templates`

Creates a draft invoice plus a recurring template with the supplied schedule.

Same UUID payload rules as invoice create, plus required `recurrencePattern`. `invoiceType` defaults to invoice; memo is rejected, which also makes `dueDate` effectively required. `isDraft` defaults to true, so `customerUuid` is not required unless `isDraft` is set to false — resume the template to start generation.

Some fields work differently in US and NZ workspaces

Showing US sales tax and NZ GST rules.

HMAC signature only

[Invoices API](https://developers.getcount.com/practice-manager/reference/invoices) [Customers API](https://developers.getcount.com/practice-manager/reference/customers) [Products & Services API](https://developers.getcount.com/practice-manager/reference/products-and-services)

#### 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

UUID of the customer billed on each generated invoice. Required only when isDraft is false.

`recurrencePattern` string required

Schedule cadence: daily, weekly, biweekly, monthly, quarterly, or yearly.

`invoiceType` enum

Document type. Defaults to invoice. Must not be memo.

One of: `invoice`, `estimate`

`invoiceNumber` string required

Invoice number shown on the generated invoice.

`date` date required

Initial invoice date (ISO).

`dueDate` date required

Due date on generated invoices (ISO). Effectively required because memo invoiceType is rejected on this endpoint.

`currency` string

ISO 4217 currency code. Defaults to workspace currency.

`recurrenceInterval` integer

Interval multiplier for the pattern. Defaults to 1.

`recurrenceEndDate` date

Optional end date for the schedule (ISO).

`occurrenceCount` integer

Limit total occurrences when set.

`inAdvanceCreationDays` integer

Days before each scheduled date to create the invoice instance.

`emailCustomer` boolean

Email the customer when each invoice is generated.

`isDraft` boolean

When true (default), the template is paused until resumed.

`products` array required

Products or services on each generated invoice.

`productUuid` uuid

Product UUID from list_products. `uuid` is accepted as an alias.

`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`

`tagUuids` array

Tag UUIDs to attach to generated invoices.

`projectUuid` uuid

Optional project UUID.

#### Responses

`201` Template and draft invoice created.

`400` Validation failed — missing recurrencePattern, invoiceNumber, date, or dueDate; memo invoiceType; or invalid UUID references.

`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` No workspace exists with the `count-workspace-id` UUID.

`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 List recurring invoice templates](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/list-recurring-invoice-templates) [Next GET Get a recurring invoice template](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/get-recurring-invoice-template)

POST `https://api.getcount.com/firm-partners/workspace/recurring-invoice-templates`

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/recurring-invoice-templates';
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",
  "recurrencePattern": "monthly",
  "recurrenceInterval": 1,
  "inAdvanceCreationDays": 0,
  "emailCustomer": true,
  "isDraft": true,
  "products": [
    {
      "productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
      "description": "Consulting services",
      "quantity": 10,
      "unitPrice": 100,
      "nonTaxable": false
    }
  ]
};
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/recurring-invoice-templates`, {
  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",
  "message": "Invoice and recurring template created",
  "data": {
    "invoice": {
      "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
      "invoiceNumber": "INV-1042"
    },
    "recurringTemplate": {
      "id": "c4d5e6f7-a8b9-0123-cdef-456789012345",
      "invoiceTitle": "Monthly consulting retainer",
      "summary": "Recurring monthly invoice for Acme Corporation",
      "email": "contact@acme.com",
      "currency": "USD",
      "subtotal": 1000,
      "taxTotal": 85,
      "total": 1085,
      "invoiceType": "invoice",
      "customer": {
        "id": "dfa3219e-6af8-4c53-997a-037534f63a35",
        "customer": "Acme Corporation",
        "email": "contact@acme.com",
        "contactName": "John Doe"
      },
      "invoiceProducts": [
        {
          "id": "d5e6f7a8-b9c0-1234-defa-567890123456",
          "productServiceId": "aa11bb22-cc33-dd44-ee55-ff6677889900",
          "description": "Consulting services",
          "quantity": 10,
          "unitPrice": 100,
          "price": 100,
          "nonTaxable": false
        }
      ],
      "createdInvoiceTemplate": {
        "recurrencePattern": "monthly",
        "recurrenceInterval": 1,
        "occurrenceCount": null,
        "remainingOccurrence": null,
        "recurrenceEndDate": null,
        "nextInvoiceDate": "2026-04-01",
        "inAdvanceCreationDays": 0,
        "creationDate": "2026-04-01",
        "emailCustomer": true
      },
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-28T14:22:30.000Z"
    }
  }
}
```
