createCustomer
createCustomerCreates a new customer record in the billing system, supporting address, tax identifiers, contact details, and custom data fields.
Instructions
Creates a new customer in the system with various attributes including address, tax info, and contact details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| external_id | No | External customer ID (optional). | |
| customer_name | Yes | Customer name (required). | |
| No | Customer primary email address (optional). | ||
| phone_number | No | Customer phone number (optional). | |
| address_line1 | No | Address line 1 (optional). | |
| address_line2 | No | Address line 2 (optional). | |
| address_line3 | No | Address line 3 (optional). | |
| address_city | No | Address city (optional). | |
| address_state | No | Address state (optional). | |
| address_zipCode | No | Address zip code (optional). | |
| address_country | No | Address country (optional). | |
| address_country_code | No | Address country code (optional). | |
| ship_to_line1 | No | Shipping address line 1 (optional). | |
| ship_to_line2 | No | Shipping address line 2 (optional). | |
| ship_to_line3 | No | Shipping address line 3 (optional). | |
| ship_to_city | No | Shipping address city (optional). | |
| ship_to_state | No | Shipping address state (optional). | |
| ship_to_zipCode | No | Shipping address zip code (optional). | |
| ship_to_country | No | Shipping address country (optional). | |
| ship_to_country_code | No | Shipping address country code (optional). | |
| communications_enabled | No | Enable/disable communications (defaults to true). | |
| auto_charge_enabled | No | Enable/disable auto-charge (defaults to true). | |
| business_entity_id | No | Business entity ID (UUID format, optional). | |
| custom_data | No | Custom key-value pairs for additional customer info (e.g., {"industry": "saas", "account_tier": "enterprise", "sales_rep": "jane"}). Optional. | |
| tax_info | No | List of tax identifiers. Each item: {country_code, tax_code, tax_id}. country_code uses mixed ISO formats (e.g. 'USA', 'IND', 'AUS', 'EU', 'GB'/'UK', 'SG', 'JP', 'BR', 'CA', and 2-letter codes for EU members like 'DE', 'FR', 'IT'). tax_code varies by country — common pairings: VAT (most of EU + UK + CH + most of MENA + IL/PH/ZA/EG/JO etc.), GST (India, Australia, Singapore), GST/HST (Canada), GST/IRD (NZ), TIN (USA, Qatar, Kuwait, Iraq, Libya), JCT (Japan), CNPJ (Brazil), SST (Malaysia), NPWP (Indonesia), MVA (Norway). Pair country_code + tax_code correctly. Optional. | |
| __userContext | No | Internal user context for multi-tenant authentication and approval workflow |