Customer Management
Create Customer
POST/customers

Creates a new customer for the authenticated merchant. This API supports: - Creating a customer with an email and/or a phone number - Associating the customer with a `storeId` or a `tpn` - Validating that the `storeId` and `tpn` belong to the authenticated merchant - Detecting duplicate customers and returning every matching customer

Header Parameters

token*
string
Idempotency-Key
string

Body Parameters

customer_externalRefId
string
email
string
phone
string
firstName*
string
lastName
string
Dba
string
Zipcode
string
City
string
State
string
storeId
string
POST/customers
1curl --location 'https://api.ipospays.tech/invoice-service/v1/customers' \
2--header 'token: ' \
3--header 'Idempotency-Key: ' \
4--header 'Content-Type: application/json' \
5--data '{
6 "customer_externalRefId": "CRM-4632357",
7 "email": "docs.full.4632357@example.com",
8 "phone": "+14044632357",
9 "firstName": "Jane",
10 "lastName": "Doe",
11 "Dba": "Jane Bakery",
12 "Zipcode": "30301",
13 "City": "Atlanta",
14 "State": "GA",
15 "storeId": "05cbaac8502f"
16}'
Response

// Awaiting response…

Sample response
{
  "data": {
    "customer_id": "LMPD9SWTTI1LI05",
    "customer_externalRefId": "CRM-4632357",
    "email": "docs.full.4632357@example.com",
    "phone": "+14044632357",
    "firstName": "Jane",
    "lastName": "Doe",
    "Dba": "Jane Bakery",
    "Zipcode": "30301",
    "City": "Atlanta",
    "State": "GA",
    "storeId": "05cbaac8502f"
  },
  "message": "Customer created successfully",
  "response_code": "SUCCESS",
  "status_code": 201,
  "request_id": "TEST-20261008183354-MDQYGU",
  "timestamp": "2026-10-08T13:03:54.158Z"
}