Creates a customer with basic information such as name, contact information, and address. To check complete list of API validations, click here.
Some fields are required only for a particular flow. Account funding additionally requires dob and nationality, and reads kyc.last_kyc_date; LRS requires phone and kyc.pan_number for a customer in India. Creating a customer is not idempotent - a second create with an email already on your account returns 400 Email has already been taken and does not return the existing record. Store the id against your own user, or recover it with GET /v1/customer?email_address=.
The name of the customer. Reserved sandbox test values: jexru7, nerqu8, havku9, dexru6 and renvak4 (any letter case) force a sanctions-screening hit whenever this customer is screened.
The phone number of the customer, with country code. Phone number validation is done using the phonelib library.
The date of birth of the customer, as a calendar date in YYYY-MM-DD format with no time or time zone. Must be a date before today.
Optional in general, required for account funding customers.
The nationality of the customer, as an ISO 3166-1 alpha-3 code. The alpha-2 form is rejected: send IND, not IN.
Optional in general, required for account funding customers.
The KYC records you already hold for this customer. Accepts exactly the two fields below.
The country where the customer is located. Country should be sent as a ISO 3166-1 alpha-3 code.
The postal code/pincode of the customer's address. List of countries where pincode is mandatory are listed here.
- Production serverhttps://api.glomopay.com/api/v1/customer
curl -i -X POST \
https://api.glomopay.com/api/v1/customer \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"name": "John Doe",
"customer_type": "individual",
"email": "customer@gmail.com",
"phone": "+91-9023456789",
"dob": "2003-11-29",
"nationality": "IND",
"kyc": {
"pan_number": "BFQPG7654R",
"last_kyc_date": "2026-02-14"
},
"address": "123 Main St",
"city": "Anytown",
"state": "Anystate",
"country": "IND",
"pincode": "560048"
}'Customer created successfully
The name of the customer. Reserved sandbox test values: jexru7, nerqu8, havku9, dexru6 and renvak4 (any letter case) force a sanctions-screening hit whenever this customer is screened.
The phone number of the customer, with country code. Phone number validation is done using the phonelib library.
The date of birth of the customer, as a calendar date in YYYY-MM-DD format with no time or time zone. Must be a date before today.
Optional in general, required for account funding customers.
The nationality of the customer, as an ISO 3166-1 alpha-3 code. The alpha-2 form is rejected: send IND, not IN.
Optional in general, required for account funding customers.
The customer's PAN (tax identification number), derived from the kyc.pan_number you send at creation. null where you sent none, and also where PAN processing is not enabled for your account; the value you sent is stored either way. Searchable via the tax_identification_number query parameter on the list-customers endpoint.
The country where the customer is located. Country should be sent as a ISO 3166-1 alpha-3 code.
The postal code/pincode of the customer's address. List of countries where pincode is mandatory are listed here.
When the customer was created, as an ISO 8601 date-time in UTC.
{ "id": "cust_5JU9yv0lGSUP", "name": "John Doe", "customer_type": "individual", "email": "customer@gmail.com", "phone": "+91-9023456789", "dob": "2003-11-29", "nationality": "IND", "tax_identification_number": "BFQPG7654R", "address": "123 Main St", "city": "Anytown", "state": "Anystate", "country": "IND", "pincode": "560048", "status": "active", "created_at": "2021-06-01T12:00:00Z", "updated_at": "2021-06-01T12:00:00Z" }