Customers

Register and log in project-scoped storefront customers, manage their addresses, and read their order history. Customer accounts are per project and are never the same as Webtools dashboard accounts.

Feature requirement: the project must have the commerce feature enabled, or these endpoints return 404.

POST …/customers/login and …/customers/register return a customer access token.
Send that token as Authorization: Bearer on every /customers/me/* route.

POST/api/v1/storefront/projects/{project_slug}/customers/login

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Request body · CustomerLogin
Field	Type		Description
email	string<email>	required	—
password	string	required	—

Response 200 · CustomerAuthResponse
Field	Type		Description
access_token	string	required	—
token_type	string	optional	—
customer	CustomerRead	required	—

Example request

curl -X POST "https://api.webtools.ng/api/v1/storefront/projects/your-project/customers/login" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "…", "password": "…" }'

POST/api/v1/storefront/projects/{project_slug}/customers/me/addresses

Create Address

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Request body · AddressCreate
Field	Type		Description
label	string (nullable)	optional	—
first_name	string	required	—
last_name	string	required	—
phone_number	string	required	—
address_line_1	string	required	—
address_line_2	string (nullable)	optional	—
city	string	required	—
state	string (nullable)	optional	—
postal_code	string (nullable)	optional	—
country_code	string	optional	—
is_default	boolean	optional	—

Response 201 · AddressRead
Field	Type		Description
label	string (nullable)	optional	—
first_name	string	required	—
last_name	string	required	—
phone_number	string	required	—
address_line_1	string	required	—
address_line_2	string (nullable)	optional	—
city	string	required	—
state	string (nullable)	optional	—
postal_code	string (nullable)	optional	—
country_code	string	optional	—
is_default	boolean	optional	—
id	string	required	—
project_id	string	required	—
customer_id	string	required	—
created_at	string<date-time>	required	—
updated_at	string<date-time>	required	—

Example request

curl -X POST "https://api.webtools.ng/api/v1/storefront/projects/your-project/customers/me/addresses" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "…", "last_name": "…", "phone_number": "…", "address_line_1": "…", "city": "…" }'

GET/api/v1/storefront/projects/{project_slug}/customers/me/orders

Customer Orders

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Response 200 (list) · OrderRead[]
Field	Type		Description
id	string	required	—
project_id	string	required	—
customer_id	string (nullable)	required	—
email	string	required	—
status	OrderStatus	required	—
payment_status	PaymentStatus	required	—
currency	string	required	—
subtotal_minor	integer	required	—
discount_minor	integer	required	—
shipping_minor	integer	required	—
tax_minor	integer	required	—
total_minor	integer	required	—
discount_code	string (nullable)	required	—
shipping_method_name	string (nullable)	required	—
shipping_address	object	required	—
billing_address	object	required	—
notes	string (nullable)	required	—
items	OrderItemRead[]	required	—
created_at	string<date-time>	required	—
updated_at	string<date-time>	required	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/customers/me/orders" \
  -H "X-Project-Key: wt_pk_your_key"

POST/api/v1/storefront/projects/{project_slug}/customers/register

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Request body · CustomerRegister
Field	Type		Description
email	string<email>	required	—
password	string	required	—
first_name	string (nullable)	optional	—
last_name	string (nullable)	optional	—
phone_number	string (nullable)	optional	—
accepts_marketing	boolean	optional	—

Response 201 · CustomerAuthResponse
Field	Type		Description
access_token	string	required	—
token_type	string	optional	—
customer	CustomerRead	required	—

Example request

curl -X POST "https://api.webtools.ng/api/v1/storefront/projects/your-project/customers/register" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "…", "password": "…" }'

← All resource groups