Skip to main content
POST
Create customer
This reference describes API version 2026-06-10. Send Commet-Version: 2026-06-10 with your request.

Authorizations

x-api-key
string
header
required

Headers

Commet-Version
string
default:2026-06-10

API version used by this reference. Send this header to select this contract explicitly.

Body

application/json
email
string<email>
required
Maximum string length: 200
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
timezone
enum<string>
default:UTC
required
Available options:
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
metadata
object
required
id
string
Maximum string length: 100
externalId
string
Maximum string length: 100
fullName
string
Maximum string length: 200
taxDocument
string
Maximum string length: 50
businessTaxId
string

Business 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.

Required string length: 1 - 30
address
object
addressId
string<uuid>
Pattern: ^([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)$
planGroupId
string

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.

Minimum string length: 1

Response

Success

success
any
required
data
object
required