Customers

A Customer in Tabs represents the businesses or individuals you're billing. This entity stores key contact information, addresses, external identifiers, and other details that help you manage billing and communication efficiently.

When creating customers, the default functionality is for Tabs to create the customer in your ERP. If you do not want this functionality, talk to your Implementation Manager or Customer Success Manager.

Customer Object

Field	Type	Description	Required
id	`string`	Unique identifier for the customer.	Yes
name	`string`	Customer's name.	Yes
defaultCurrency	`string`	Currency code (e.g., USD) used for invoices and payments.	Yes
primaryBillingContactName	`string`	Name of the customer's main billing contact.	Yes
primaryBillingContactEmail	`string`	Email of the main billing contact.	Yes
secondaryBillingContacts	`string[]`	List of secondary billing contact emails.	No
billingAddress	`Address`	The primary address for billing.	Yes
shippingAddress	`Address`	The primary address for shipping (if different from billing).	No
externalIds	`ExternalId[]`	Optional external identifiers referencing other systems.	No
lastUpdatedAt	`Date`	Timestamp of the last update to this customer record.	Yes

Address Object

Field	Type	Description	Required
externalId	`string`	Unique identifier for the address (if any).	No
city	`string`	City name.	Yes
state	`string`	State/province name.	Yes
country	`string`	Country name.	No
zip	`string`	Postal or ZIP code.	Yes
address1	`string`	Primary street address.	Yes
address2	`string`	Secondary address line (apt, suite, etc).	No
addressee	`string`	Name of recipient/addressee.	No

ExternalId Object

Field	Type	Description	Required
type	`string` (enum: external ID source)	Specifies the source of the external ID (e.g., Salesforce).	Yes
id	`string`	The external identifier value itself.	Yes