API v1FiatPe Home
FiatPeDocs

Create Customer

POSThttps://api.fiatpe.com/v1/customers//v1/customers/
Copy

Create a new customer by providing details such as name, email address, phone number, GSTIN, and metadata. You can also use the allow_existing parameter to return an existing customer when both the email address and phone number match an existing record.

Headers

Sent as Authorization: Basic base64(Api Key:Salt Key)

Body Parameters

name*string

The customer’s full name. It must contain between 2 and 120 characters.

email*string

The customer’s valid email address. It is used to identify and communicate with the customer.

phone*string

The customer’s valid mobile number, including the country code where applicable.

gstinstring

The customer’s valid 15-character GST Identification Number (GSTIN).

allow_existingboolean

Determines whether an existing customer record can be returned instead of creating a duplicate. The default value is false. When set to true, both the provided email address and phone number must match an existing customer

metadatajson object

A set of custom key-value pairs used to store additional information about the customer. You can provide up to 15 entries. Each key can contain 1–50 characters, and each value can contain up to 200 characters.