v2

latestOpenAPI 3.0.0Commercial2026-07-2649110209.4 KB

Customers

Update a customer

patch/v1/customers

Request body

customer_idstring required

The ID of the customer to update.

namestring

The full name of the customer.

metadataobject

Additional metadata for the customer.

Example request

{
  "customer_id": "cust_abc123",
  "name": "John Doe",
  "metadata": {
    "key": "value"
  }
}

Response

Successfully updated the customer

idstring required

Unique identifier for the object.

mode'test' | 'prod' | 'sandbox' required

String representing the environment.

objectstring required

String representing the object’s type. Objects of the same type share the same value.

emailstring required

Customer email address.

namestring nullable

Customer name.

metadataobject nullable

Additional metadata associated with the customer.

countrystring nullable required

The ISO 3166-1 alpha-2 country code for the customer.

created_atstring date-time required

Creation date of the customer

updated_atstring date-time required

Last updated date of the customer

Example response

{
  "email": "user@example.com",
  "name": "John Doe",
  "metadata": {
    "key": "value"
  },
  "country": "US",
  "created_at": "2023-01-01T00:00:00Z",
  "updated_at": "2023-01-01T00:00:00Z"
}