Create a credit memo
/partners/invoicesCreates a credit memo for a customer.
Set invoiceType to memo. Optionally pass appliedToInvoiceUuid to link the memo to an open invoice at create time. Line item rules match invoice create. invoiceNumber is required.
Some fields work differently in US and NZ workspaces
Showing US sales tax and NZ GST rules.
Request body
customerUuiduuidrequiredUUID of the customer receiving the credit.
invoiceTypeenumrequiredMust be memo.
One of: memo
invoiceNumberstringrequiredCredit memo number shown to the customer.
datedaterequiredMemo date (ISO).
appliedToInvoiceUuiduuidUUID of an open invoice to credit at create time.
currencystringISO 4217 currency code.
productsarrayrequiredCredit line items.
productUuiduuidProduct UUID from list_products. `uuid` is accepted as an alias. Omit it for a free-text line.
categoryAccountUuiduuidIncome account UUID from the Chart of Accounts. Required on a free-text line; on a product line it overrides the product's income account.
namestringItem name on a free-text line.
descriptionstringLine description.
quantitynumberrequiredQuantity.
unitPricenumberrequiredCredit amount per unit.
taxesarrayTax 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 taxThe sales tax codes to charge on the line.
- NZ· GSTThe 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`.
nonTaxablebooleanRaise the line without charging tax.
- US· Sales taxThe line keeps its tax code, charges no tax, and reports as a Non-Taxable sale under that code.
- NZ· GSTClears 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.
customerExemptionOverriddenbooleanCharge tax on this line even though the customer is tax-exempt (`taxExcluded`).
- US· Sales taxWithout it, a tax-exempt customer's taxed lines are raised Non-Taxable.
- NZ· GSTIgnored. Every line for a tax-exempt customer is raised with no tax.
productsPriceTypeenumHow 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
notesstringMemo notes visible to the customer.
tagUuidsarrayTag UUIDs to attach.
Responses
201Credit memo created.400Validation failed.404Customer, product, or applied invoice not found.401Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. Troubleshoot403The credential does not have access to this workspace or resource. Troubleshoot429Rate limit exceeded (100 requests per minute per user of each app, or 10,000 per minute per app). Retry after the Retry-After header. Troubleshoothttps://api.getcount.com/partners/invoicesimport 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 ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;
const method = 'POST';
const signingPath = '/invoices';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
"customerUuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
"invoiceType": "memo",
"invoiceNumber": "CM-0042",
"date": "2026-03-01",
"appliedToInvoiceUuid": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"currency": "USD",
"products": [
{
"productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
"description": "Credit for overbilling on prior invoice",
"quantity": 1,
"unitPrice": 500,
"nonTaxable": true
}
]
};
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}/partners/invoices`, {
method,
headers: {
'x-client-id': CLIENT_ID,
'x-timestamp': timestamp,
'x-signature': signature,
'Content-Type': 'application/json',
Authorization: `Bearer ${ACCESS_TOKEN}`,
},
body: bodyString,
});
console.log(await response.json());{
"status": "success",
"data": {
"invoice": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"invoiceNumber": "CM-0042",
"invoiceType": "memo",
"customerUuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
"appliedToInvoiceUuid": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"date": "2026-03-01",
"dueDate": null,
"currency": "USD",
"status": "draft",
"isDraft": true,
"approved": false,
"isSent": false,
"paymentStatus": "unpaid",
"subtotal": 500,
"taxTotal": 0,
"total": 500,
"amountDue": 500,
"products": [
{
"productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
"description": "Credit for overbilling on prior invoice",
"quantity": 1,
"unitPrice": 500,
"nonTaxable": true
}
],
"createdAt": "2026-03-01T09:00:00.000Z",
"updatedAt": "2026-03-02T11:15:00.000Z"
}
}
}