Customer

Canonical representation of a customer entity. Produced by CRM systems (e.g., Salesforce, HubSpot, custom CRM) on customer lifecycle events (created, updated, churned).

Properties

Field	Type	Description
customerId*	string	Unique customer identifier
companyName	string	Legal company or organization name
tradingName	string	Trading or brand name, if different from legal name
status	enum	Current customer lifecycle status prospectactiveinactivechurned
industry	string	Industry or sector the customer operates in
website	stringuri	Customer website URL
primaryContact	objectContact Information	Primary contact person
email	stringemail	Primary email address
phoneNumber	string	Phone number in E.164 format (e.g., +33612345678) pattern: ^\+[1-9]\d{1,14}$
billingAddress	objectAddress	Billing address
streetAddress	string	Street name, number, and any additional line (apt, suite, etc.)
city	string	City or locality name
stateOrProvince	string	State, province, region, or equivalent administrative division
postalCode	string	Postal or ZIP code
country*	string	ISO 3166-1 alpha-2 country code
shippingAddress	objectAddress	Shipping address, if different from billing
streetAddress	string	Street name, number, and any additional line (apt, suite, etc.)
city	string	City or locality name
stateOrProvince	string	State, province, region, or equivalent administrative division
postalCode	string	Postal or ZIP code
country*	string	ISO 3166-1 alpha-2 country code
taxId	string	Tax identification number (VAT, EIN, etc.)
accountManagerId	string	Identifier of the assigned account manager
createdAt	stringdate-time	Timestamp when the customer record was created (ISO 8601)
tags	array<object>	Metadata tags for segmentation and filtering maxItems: 50
key*	string	Tag key: alphanumeric, hyphens, and underscores allowed pattern: ^[a-zA-Z0-9_-]{1,64}$maxLength: 64
value*	string	Tag value maxLength: 256