• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Delete customer

DELETE /v2/customers/{customer_id}

Deletes a customer profile from a business.

This operation also unlinks any associated cards on file.

As a best practice, include the version field in the request to enable optimistic concurrency control. If included, the value must be set to the current version of the customer profile.

To delete a customer profile that was created by merging existing profiles, you must use the ID of the newly created profile.

Permissions
CUSTOMERS_WRITE
Guide
Delete a customer profile Try in API Explorer

Path Parameters

Example code
Name Description
customer_id
string
Required

The ID of the customer to delete.

Query Parameters
Name Description
version
integer (64-bit)

The current version of the customer profile.

As a best practice, you should include this parameter to enable optimistic concurrency control. For more information, see Delete a customer profile.

Response Fields
Name Description
errors
Error [ ]

Any errors that occurred during the request.

Examples

You are viewing an old version of the API
DELETE /v2/customers/{customer_id}
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js 
curl https://connect.squareup.com/v2/customers/customer_id0?version=11 \
  -X DELETE \
  -H 'Square-Version: 2023-01-19' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON 
{}