Customer Tax IDs
September 24th, 2026
Customers now carry tax_ids, a list of { "type", "value" } objects, on POST /customers,
PUT /customers/{customer_id}, GET /customers/{customer_id}, GET /customers, and the
customer-created and customer-updated webhooks. type is EU_VAT_REGISTRATION_NUMBER or
GENERIC_VAT_NUMBER.
On POST, omit tax_ids for no tax IDs. On PUT, omit tax_ids to keep the customer's current tax
IDs, send an empty list to clear them, or send a list to replace them all. Adding or changing tax IDs
requires the customer to have an address, and they are validated with the organization's tax provider
when one is connected. If validation fails, nothing about the customer is created or changed.
Applies to V1, V2, V3, and V4.