Onboard new customer

📘
API Refs

Staging: Onboard new customer

Request body

Name	Type	Description	Required
email	string	Customer email address	yes
firstName	string	Customer first name	no
lastName	string	Customer last name	no
phone	string	Customer phone number	no
address	object	Customer billing address	no

Address object

Name	Type	Description	Required
line1	string	Street address line 1	yes
line2	string	Street address line 2	no
city	string	City	yes
state	string	State or province	yes
postal_code	string	ZIP or postal code	yes
country	string	Two-letter country code	no

Response

Returns a 201 Created status with:

customer: The created customer object
stripeCustomerId: The Stripe StripeCustomerID for future API calls
message: Success message
subscriptionLink: Optional subscription link (if applicable)

Description

This endpoint creates a new customer account with Stripe integration. The customer can then be subscribed to plans or make one-time payments. This is the first step in establishing a billing relationship with a new customer. Note that payment methods are not set up in this endpoint - they should be configured separately through Stripe's payment method APIs or during subscription creation.