Create a new customer

post

https://{domain_prefix}.retail.lightspeed.app/api/2026-04/customers

Creates a new customer.

🔒 Requires: customers:write scope

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

company_name

string | null

Company name.

custom_field_1

string | null

Custom field 1. Can be used to store random data.

custom_field_2

string | null

Custom field 2.

custom_field_3

string | null

Custom field 3.

custom_field_4

string | null

Custom field 4.

customer_code

string

Customer code used for claiming loyalty.

customer_group_id

string

Customer group ID.

date_of_birth

string

Birthday.

do_not_email

boolean

Defaults to false

Indicates whether the customer opted out of email communications.

string | null

Customer's email address.

enable_loyalty

boolean

enable_promotional_sms

boolean

Defaults to false

Indicates whether the customer opted in to SMS communications.

fax

string | null

Fax no.

first_name

string | null

required

Customer's first name.

gender

string | null

Customer's gender. Can be M, F or null.

last_name

string | null

required

Customer 's last name.

mobile

string | null

Mobile phone no.

note

string | null

Customer note.

on_account_limit

double | null

Customer's OnAccount Limit.

phone

string | null

Phone no.

physical_address_1

string | null

Physical address, line 1.

physical_address_2

string | null

Physical address, line 2.

physical_city

string | null

Physical address, city.

physical_country_id

string | null

Physical address, country code.

physical_postcode

string | null

Physical address, post code.

physical_state

string | null

Physical address, state.

physical_suburb

string | null

Physical address, suburb.

postal_address_1

string | null

Postal address, line 1.

postal_address_2

string | null

Postal address, line 2.

postal_city

string | null

Postal address, city.

postal_country_id

string | null

Postal address, country code.

postal_postcode

string | null

Postal address, post code.

postal_state

string | null

Postal address, state.

postal_suburb

string | null

Postal address, suburb.

tax_id

string | null

Customer's tax ID.

twitter

string | null

Twitter handle.

website

string | null

Website URL.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

new

201