Customer Management
Edit Customer
PUT/customers/{customer_id}

Updates an existing customer belonging to the authenticated merchant. Updates only the fields that are sent. A field sent empty (`""` or `null`) is cleared; a field that is not in the request keeps its stored value. Send at least one field. Not allowed while one of the customer's invoices has an active payment link. A customer who has invoices cannot be moved to another store. create a new customer under that store instead.

Path Parameters

customer_id*
string

Header Parameters

token*
string

Body Parameters

customer_externalRefId
string
email
string
phone
string
firstName
string
lastName
string
Dba
string
Zipcode
string
City
string
State
string
PUT/customers/{customer_id}
1curl --location --request PUT 'https://api.ipospays.tech/invoice-service/v1/customers/LMPD9SWTTI1LI05' \
2--header 'token: ' \
3--header 'Content-Type: application/json' \
4--data '{
5 "customer_externalRefId": "CRM-1258819-B",
6 "email": "docs.full.1258819@example.com",
7 "phone": "+14041258819",
8 "firstName": "Jane",
9 "lastName": "Smith",
10 "Dba": "Jane Cakes",
11 "Zipcode": "34343",
12 "City": "New Town",
13 "State": "FL"
14}'
Response

// Awaiting response…

Sample response
{
  "data": {
    "customer_id": "LMPD9SWTTI1LI05",
    "customer_externalRefId": "CRM-1258819-B",
    "email": "docs.full.1258819@example.com",
    "phone": "+14041258819",
    "firstName": "Jane",
    "lastName": "Smith",
    "Dba": "Jane Cakes",
    "Zipcode": "34343",
    "City": "New Town",
    "State": "FL",
    "storeId": "05cbaac8502f"
  },
  "message": "Customer updated successfully",
  "response_code": "SUCCESS",
  "status_code": 200,
  "request_id": "TEST-20261008183423-CPEXH9",
  "timestamp": "2026-10-08T13:04:23.307Z"
}