---
title: "Recurring Invoice Templates · Practice Manager API · COUNT Partner API"
description: "Recurring invoice templates define a schedule that automatically generates invoices (or estimates) in a workspace. Each template stores the invoice payload…"
canonical: "https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates"
source: "https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates"
---
Practice Manager API

# Recurring Invoice Templates

Recurring invoice templates define a schedule that automatically generates invoices (or estimates) in a workspace. Each template stores the invoice payload, recurrence cadence, and next run date. Credit memos cannot be recurring.

Last updated 2026-11-18

Some fields work differently in US and NZ workspaces

Showing US sales tax and NZ GST rules.

## Overview

The Recurring Invoice Templates API lets your integration list, create, update, pause, resume, and delete scheduled invoice templates. A template holds the same invoice-shaped fields as a one-off invoice — customer, line items, taxes, and totals — plus recurrence settings that control when new invoices are generated.

Templates are identified by a UUID returned as `id` in partner responses. Pause stops generation by clearing `nextInvoiceDate`; resume requires you to supply a new `nextInvoiceDate` in the request body. Credit memos (`invoiceType: "memo"`) are rejected on create — use the Invoices API for memos.

## Key concepts

### Identification

A template is referenced by its UUID, returned as `id`. Pass that value in the path for retrieve, update, pause, resume, and delete.

### Create payload

POST uses the same UUID field rules as invoice create (`customerUuid`, product UUIDs on line items, `tagUuids`) plus a required `recurrencePattern`. Optional `inAdvanceCreationDays`, `recurrenceInterval`, `recurrenceEndDate`, and `emailCustomer` control scheduling.

### Draft and pause

New templates default to draft (`isDraft: true`) and are paused until you resume them with a `nextInvoiceDate`. POST `/{uuid}/pause` sets `nextInvoiceDate` to null and stops generation without deleting the template.

### Resume requires nextInvoiceDate

POST `/{uuid}/resume` must include `nextInvoiceDate` (ISO date) in the JSON body. The API returns 400 if it is missing.

### Credit memos excluded

Setting `invoiceType` to `memo` on create returns 400. Credit memos are one-off documents created through POST /firm-partners/workspace/invoices.

### US· Sales taxLine taxes

Each line charges the sales tax codes in its `taxes` array, or the product's codes when `taxes` is omitted. `nonTaxable: true` keeps the code but charges no tax, so the sale reports as Non-Taxable under that code. A tax-exempt customer's taxed lines are raised Non-Taxable unless the line sends `customerExemptionOverridden: true`.

### NZ· GSTLine GST codes

Each line carries a GST code in `taxes`: `15% GST on Income` (standard-rated), `Zero Rated` (counted in GST return boxes 5 and 6), or `No GST` (left off the GST return). Zero Rated and No GST are both 0% but are different codes. Pick them by UUID from List tax codes. `nonTaxable: true` and `taxes: []` both raise the line with no code at all, which is never a zero-rated supply.

## The recurring invoice template object

Fields returned on a template. Recurrence-specific settings are nested under `createdInvoiceTemplate`; line items appear as `invoiceProducts`.

#### Attributes

`id` uuid

Template identifier (UUID). Use in path parameters.

`invoiceTitle` string

Display title for generated invoices.

`summary` string

Optional summary or memo line on generated invoices.

`email` string

Customer email used when emailing generated invoices.

`currency` string

ISO 4217 currency code.

`subtotal` number

Subtotal before tax.

`taxTotal` number

Total tax amount.

`total` number

Grand total including tax.

`invoiceType` enum

Document type generated from this template. Cannot be memo.

One of: `invoice`, `estimate`

`customer` object

Embedded customer record with billing details.

`invoiceProducts` array

Line items (products/services) on each generated invoice.

`createdInvoiceTemplate` object

Recurrence schedule and generation settings.

`recurrencePattern` enum

Cadence unit. Aliases like biweekly and quarterly are normalized on save.

One of: `daily`, `weekly`, `monthly`, `yearly`

`recurrenceInterval` integer

Interval multiplier for the pattern (for example every 2 months when pattern is monthly and interval is 2).

`occurrenceCount` integer

Total number of occurrences when limited; null for open-ended schedules.

`remainingOccurrence` integer

Occurrences left before the schedule ends.

`recurrenceEndDate` date

Optional end date for the schedule (ISO).

`nextInvoiceDate` date

Next invoice date (ISO). Null when the template is paused.

`inAdvanceCreationDays` integer

Days before each scheduled date that the invoice instance is created.

`creationDate` date

Date the next invoice instance will be created (ISO).

`emailCustomer` boolean

When true, generated invoices are emailed to the customer automatically.

`project` object

Linked project, when set, or null.

`attachments` array

Attachments copied to each generated invoice.

`tags` array

Tags applied to generated invoices.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "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"
}
```

List excludes draft templates by default

GET /firm-partners/workspace/recurring-invoice-templates returns only non-draft templates (`isDraft: false`) unless you pass `isDraft=true` or `isDraft=all`. A template stays `isDraft: true` (and is skipped by the recurrence job) until its seed invoice is approved.

Search

The `search` query parameter matches invoice title, summary, email, customer name, and rounded total amounts.

Supported recurrence patterns

Accepted values include daily, weekly, biweekly, monthly, quarterly, and yearly. Unsupported patterns return 400 with a descriptive message.

## Related

- [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)

## Endpoints

[GET List recurring invoice templates `/firm-partners/workspace/recurring-invoice-templates` Returns a paginated list of recurring invoice templates in the workspace.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/list-recurring-invoice-templates) [POST Create a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates` Creates a draft invoice plus a recurring template with the supplied schedule.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/create-recurring-invoice-template) [GET Get a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates/{uuid}` Retrieves a single recurring invoice template by its UUID.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/get-recurring-invoice-template) [PATCH Update a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates/{uuid}` Updates an existing recurring invoice template. Only sent fields are changed.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/update-recurring-invoice-template) [DELETE Delete a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates/{uuid}` Removes a recurring invoice template and stops future generation.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/delete-recurring-invoice-template) [POST Pause a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates/{uuid}/pause` Pauses generation by clearing nextInvoiceDate.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/pause-recurring-invoice-template) [POST Resume a recurring invoice template `/firm-partners/workspace/recurring-invoice-templates/{uuid}/resume` Resumes generation by setting nextInvoiceDate.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/resume-recurring-invoice-template) [GET List template attachments `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments` Lists the files attached to a recurring invoice template.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/list-recurring-invoice-template-attachments) [POST Add template attachments `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments` Adds files to a recurring invoice template from public URLs or inline base64 content.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/add-recurring-invoice-template-attachments) [POST Upload template attachment `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments/upload` Uploads one file to a recurring invoice template via multipart form data.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/upload-recurring-invoice-template-attachment) [PATCH Rename template attachment `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments/{attachmentUuid}` Changes the display title of one template attachment.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/update-recurring-invoice-template-attachment) [DELETE Delete template attachment `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments/{attachmentUuid}` Removes one file from a recurring invoice template.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/delete-recurring-invoice-template-attachment) [GET Get template attachment content `/firm-partners/workspace/recurring-invoice-templates/{uuid}/attachments/{attachmentUuid}/content` Returns one template attachment's file, base64-encoded.](https://developers.getcount.com/practice-manager/reference/recurring-invoice-templates/get-recurring-invoice-template-attachment-content)
