Add a customer
/firm-partners/workspace/customersCreates a new customer in the workspace.
Only customer (the name) is required. Addresses, contacts, and taxes can be created inline.
Some fields work differently in US and NZ workspaces
Showing US sales tax and NZ GST rules.
Headers
count-workspace-iduuidrequiredUUID 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
customerstringrequiredCustomer or business name. The only required field.
emailstringPrimary contact email. Optional; does not need to be unique.
mainPhonestringPrimary phone number. International format recommended.
websitestringWebsite URL. Stored with an https:// prefix if the protocol is omitted.
notesstringFree-text notes. HTML is sanitized.
statusenumCustomer status. Defaults to active.
One of: active, inactive
paymentTermstringDefault payment term for invoices (for example net30).
taxNumberstringTax registration number.
salesRepIdintegerId of the workspace person to assign as sales representative.
taxAutoCalculatebooleanDerive tax from the address. Defaults to false; when true, any `taxes` sent are discarded.
- US· Sales taxSales tax comes from the shipping (else billing) address.
taxExcludedbooleanMark the customer tax-exempt. Defaults to false.
- US· Sales taxTheir taxed invoice lines are raised Non-Taxable unless a line sends `customerExemptionOverridden: true`.
- NZ· GSTTheir invoice lines are raised with no GST code.
taxesarrayTax UUIDs from List tax codes, applied when `taxAutoCalculate` is false. Numeric ids are rejected.
billingAddressobjectBilling address for the customer.
streetstringStreet address.
citystringCity or locality.
statestringState, province, or region.
zipCodestringPostal or ZIP code.
countrystringCountry name or ISO code.
shippingAddressobjectShipping address. Same shape as billingAddress.
contactsarrayContact people for this customer. The first contact sets the derived contactName.
firstNamestringrequiredContact's first name.
lastNamestringrequiredContact's last name.
emailstringContact's email address.
phonestringContact's phone number.
isPrimarybooleanMarks the primary contact.
Responses
201Customer created successfully.400Bad request — validation failed.401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot403The 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. Troubleshoot404No workspace exists with the `count-workspace-id` UUID.429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). Troubleshoothttps://api.getcount.com/firm-partners/workspace/customersimport 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/customers';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
"customer": "Acme Corporation",
"email": "contact@acme.com",
"mainPhone": "+1234567890",
"website": "https://acme.com",
"status": "active",
"paymentTerm": "net30",
"billingAddress": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zipCode": "94102",
"country": "USA"
},
"contacts": [
{
"firstName": "John",
"lastName": "Doe",
"email": "john@acme.com",
"isPrimary": 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}/firm-partners/workspace/customers`, {
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());{
"status": "success",
"message": "success on creating customer",
"data": {
"customer": {
"id": "dfa3219e-6af8-4c53-997a-037534f63a35",
"customer": "Acme Corporation",
"email": "contact@acme.com",
"mainPhone": "+1234567890",
"website": "https://acme.com",
"status": "active",
"notes": "Preferred customer. Net-30 terms.",
"paymentTerm": "net30",
"taxNumber": null,
"taxAutoCalculate": false,
"taxExcluded": false,
"contactName": "John Doe",
"billingAddress": {
"id": "0b2c1f5e-7a9d-4f2b-9c1e-2a4b6d8e0f12",
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zipCode": "94102",
"country": "USA"
},
"shippingAddress": null,
"contacts": [
{
"id": "a5da3577-bf85-4e3a-aa73-df85ca69bc67",
"firstName": "John",
"lastName": "Doe",
"email": "john@acme.com",
"phone": "+1234567890",
"isPrimary": true
}
],
"taxes": [],
"salesRep": null,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-28T14:22:30.000Z"
}
}
}