Sign in

v1

latestOpenAPI 3.1.02026-07-24170121.2 MB

Update a Customer

This API updates details of a customer by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

patch/v1/customers/{customer_id}

Path parameters

customer_idstring required

customer_id refers to a specific customer whose details need to be updated.

Headers

Acceptstring required

Indicates which content types, expressed as MIME types, the client is able to understand.

Content-Typestring required

Indicates the media type of the resource sent in the HTTP message body. <br /><br /><b>Possible Values:</b><br /> application/json<br />application/x-www-form-urlencoded

Request body

emailstring

Email address of the customer. It is displayed next to the customer in the dashboard and can be used for searching and tracking.

namestring

Name of the customer.

descriptionstring

An arbitrary string that you can attach to a customer. It is displayed next to the customer in the dashboard.

send_email_addressstring

Email address to which the invoices will be sent.

cc_email_addressstring

Email address to which the invoices will be sent.

countrystring

Customer's country name.

address_1string

The customer's address for line 1.

address_2string

The customer's address for line 2.

citystring

The cutomer's city name. Can be a City/District/Suburb/Town/Village.

statestring

The customer's state name. Can be State/County/Province/Region.

zipinteger

The customer's ZIP code.

phoneinteger

The customer's phone number.

token_idstring

The token issued by the token service provider. A token is generated to represent the credit card number.

default_card_idstring

ID of the customer's card that should be set as default.

Response

200

Example response

{
  "data": {
    "object": "customer",
    "customer_id": "DPpKjVKD4x44VnMN",
    "name": "BBB",
    "email": "foo@someplace.com",
    "description": "fdsgdsg",
    "send_email_address": "foo@someplace.com",
    "cc_email_address": "foo@someplace.com",
    "address_1": "foo",
    "address_2": "foo",
    "city": "foo",
    "state": "NY",
    "zip": "11501",
    "phone": "5555555555",
    "country": "foo",
    "created_at": 1724443709,
    "updated_at": 1724444312,
    "readable_created_at": "10 minutes ago",
    "readable_updated_at": "1 second ago",
    "invoice_prefix": "U6TQ"
  },
  "meta": {
    "include": [
      "card"
    ]
  }
}