Create a customer

post

https://sandbox-api.heypongo.com/v1/customers

Required scopes:

customer.create

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

international_phone_number

string

required

The customer's phone number in international format without '+' prefix.

store_id

string

Store id associated to the customer. This field is required when reference_store_slug is not present. The public_id of an existing record in the stores table.

reference_store_slug

string

required

The store slug where the customer is created.

string | null

Customer valid email. Must be a valid email address.

loyalty_card_number

string | null

tags

has_optin

boolean | null

Set to true if the user has optin for commercial sms.

has_optin_email

boolean | null

Set to true if the user has optin for commercial email.

points

integer | null

Number of points to add to the customer.

first_name

string | null

Customer first name.

last_name

string | null

Customer last name.

gender

string | null

enum

Customer gender. Possible values are "man", "woman", "undisclosed" and "other".

Allowed:

birthday

string | null

Customer birthday in format YYYY-MM-DD. Must be a valid date in the format Y-m-d. Must be a date before 2026-04-23.

string | null

Customer secret 4 digits PIN. Must match the regex /^\d{4}$/. Must be at least 4 characters. Must not be greater than 4 characters.

payment_method_hash

string | null

Hash of the new customer payment method. Must not be one of unknown.

Responses

201

403

409

422