Update customer

patch

https://sandbox-api-gtw.softpoint.io/api/{version}/customers/{customer_id}

This API is used to update a customer's profile.

It returns the updated customer.

Note: Send only the fields to change; address fields are merged. The same fields and rules as Create customer apply. Not allowed when the customer is shared with locations outside your key (editable: false).

URL

{{interface_url}}/{{version}}/customers/{{customer_id}}

Method

PATCH

Headers

Authorization: Bearer {access_token} (or Api-Key)

Request Parameters

Field	Type	Required	Description
first_name	String	No	Max 64.
last_name	String	No	Max 64.
email	String	No	Valid email, max 64.
phone	String	No	7-15 digits. Send `phone_country_id` with it.
phone_country_id	Integer	Conditional	Required with `phone`.
customer_id_external	String	No	Max 45.
gender	Integer	No	`0`, `1` or `2`.
citizenship	String	No	Max 20.
address.*	Object	No	`line1`, `line2`, `city`, `zipcode`, `state_id`, `country_id`.

URL Parameters

Parameter	Required/Optional	Type	Description
customer_id	Required	Integer	Our customer ID (`id` returned by Create customer).

Example Request (cURL)

curl --location --request PATCH '{{interface_url}}/{{version}}/customers/{{customer_id}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
  "last_name": "Garcia Lopez",
  "address": {
    "city": "Dallas"
  }
}'

Example Response (JSON) — 200

{
  "id": 48213,
  "customer_id_external": "CRM-1001",
  "first_name": "Ana",
  "last_name": "Garcia Lopez",
  "email": "[email protected]",
  "phone": "5125550134",
  "phone_country_id": 3,
  "gender": 2,
  "citizenship": null,
  "address": {
    "line1": "100 Main St",
    "line2": null,
    "city": "Dallas",
    "zipcode": "78701",
    "state_id": null,
    "country_id": 3
  },
  "email_verified_at": null,
  "phone_verified_at": null,
  "status": "active",
  "editable": true,
  "locations": [
    {
      "location_id": 279685,
      "name": "Main Street",
      "linked_at": "2026-11-05T18:16:18Z"
    }
  ],
  "payment_methods_count": {
    "card": 1,
    "ach": 0
  },
  "created_at": "2026-11-05T18:16:18Z",
  "updated_at": "2026-11-05T18:16:18Z"
}

Error Responses

Format: { "error": { "code", "name", "message", "details" } }

Status	Error	When
400	missing_required_parameters	Invalid field (see `error.details`).
404	customer_not_found	Wrong ID, or not in your scope.
409	customer_profile_shared	The customer is shared with locations outside your key.

Response

200OK