Skip to main content
PATCH
Update customer
This reference describes API version 2026-07-31. Send Commet-Version: 2026-07-31 with your request.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string

Unique key used to safely retry this write for 24 hours without applying it twice.

Required string length: 1 - 200
Commet-Version
string
default:2026-07-31

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

Path Parameters

id
string
required

Body

application/json
email
string<email>
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,}$
fullName
string
Maximum string length: 200
taxDocument
string
Maximum string length: 50
businessTaxId
string | null

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. Send null to remove it.

Required string length: 1 - 30
externalId
string
Maximum string length: 200
timezone
enum<string>
default:UTC
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
address
object

Response

Success

id
string
required
externalId
string | null
required
fullName
string | null
required
email
string
required
taxDocument
string | null
required
documentType
string | null
required
businessTaxId
object | null
required
timezone
string | null
required
metadata
object | null
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
object
string
required
Allowed value: "customer"
livemode
boolean
required