Create customer
Create a new customer. Idempotent when customerId is provided. With planGroupId, a customer without an open subscription starts on that group’s starting plan (see planGroupId), and the externalId of a deleted customer is rejected.
2026-05-18. Send Commet-Version: 2026-05-18 with your request.Authorizations
Headers
API version used by this reference. Send this header to select this contract explicitly.
Body
UTC, America/New_York, America/Chicago, America/Denver, America/Los_Angeles, America/Sao_Paulo, America/Mexico_City, America/Buenos_Aires, America/Santiago, America/Bogota, America/Lima, America/Asuncion, Europe/London, Europe/Paris, Europe/Berlin, Europe/Madrid, Asia/Tokyo, Asia/Shanghai, Asia/Singapore, Asia/Dubai, Australia/Sydney 200^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$10010020050Business tax ID, such as an EU VAT number, a Peruvian RUC or an Argentine CUIT, for the country of the customer's address; its type comes from that country. Where Commet collects tax and that ID exempts business buyers, a valid ID replaces consumer tax with the business treatment; elsewhere it is stored as sent and does not change any charge.
1 - 30^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Plan group whose starting plan the customer starts on when it has no open subscription: its signup trial, a trial without a payment method, when the group has one and the customer never had that plan, otherwise its default plan. A customer who already had the signup trial plan in a group without a default plan starts on none. Without it, no plan is assigned.
1