Customers

The Customers API allows partner applications to manage customer records in COUNT.Customers represent individuals or organizations that you bill, invoice, or transact with.

This API enables you to:

• List customers associated with your team

• Retrieve customer details using a UUID

• Create and update customer records

• Search for customers by email

All customer data is securely scoped to the authenticated team.

---

Authentication

All Customers API endpoints require both authentication mechanisms:

HMAC Authentication

Include the following headers in every request:

• x-client-id

• x-signature

OAuth Bearer Token

Include a valid access token obtained via the OAuth flow:

Authorization: Bearer YOUR_ACCESS_TOKEN

Requests missing either authentication method will be rejected.

---

Customer Identification

• All customers are identified using UUIDs

• Integer or internal IDs are not exposed to partner applications

• UUIDs are returned in all customer-related responses and must be used in subsequent requests

---

Email Uniqueness

• Customer email addresses must be unique within a team

• Attempting to create a customer with an existing email will result in an error

• Use the Find Customer by Email endpoint to check for existing customers before creation

---

Addresses

Customers can have both:

• Billing Address

• Shipping Address

Each address supports the following fields:

• street

• city

• state

• zipCode

• country

---

Contacts

• A customer may have multiple contacts

• One contact can be marked as the primary contact

• Contacts include name, email, phone number, and primary status

---

Available Endpoints

Use the endpoints below to manage customers:

• List Customers – Retrieve all customers for your team

• Get Customer – Retrieve a customer by UUID

• Create Customer – Create a new customer record

• Update Customer – Update an existing customer

• Find Customer by Email – Search for a customer using an email address