Create Customer
Customers
Create Customer
Create a new customer in the system
POST
Create Customer
Description
This endpoint allows you to create a new customer in the LatePoint system. You can provide basic or complete customer information, including contact details, address, preferences, and custom fields.Authentication
Your LatePoint API Key with write permissions
Request Body
Required Fields
Customer’s first nameValidations:
- Minimum 2 characters
- Maximum 50 characters
- Only letters, spaces, and hyphens
Customer’s last nameValidations:
- Minimum 2 characters
- Maximum 50 characters
- Only letters, spaces, and hyphens
Optional Fields
Customer’s email (optional for API, must be unique if provided)Validations:
- Valid email format
- Unique in the system
- Maximum 100 characters
Email is optional when creating customers via API. However, if you provide an email, it must be valid and unique.
Customer’s phone numberValidations:
- Valid phone format
- Can include country code
- Maximum 20 characters
Initial customer statusPossible values:
active- Active customer (default)inactive- Inactive customerpending- Pending verification
Customer’s date of birth (format: YYYY-MM-DD)
Customer’s genderPossible values:
male- Malefemale- Femaleother- Otherprefer_not_to_say- Prefer not to say
Address Information
Customer’s street address
Customer’s city
Customer’s state or province
Customer’s ZIP or postal code
Customer’s country
Custom Fields
Custom fields defined in your configurationExample:
Additional notes about the customerValidations:
- Maximum 1000 characters
Additional Information
Whether the customer is a guest (no account)
Associated WordPress user ID (if applicable)
Response
Successful Response (201 Created)
Response status (“success”)
Confirmation message
Created customer information
Examples
Basic Customer
Complete Customer with Address
Customer Without Email (API Only)
This example shows how to create a customer without an email address, which is only possible via API.
Create Customer from Web Form
Example Response
Customer Created Successfully
Error Codes
Automatic Validations
Data Validations
-
First and Last Name:
- Minimum 2 characters, maximum 50
- Only letters, spaces, hyphens and apostrophes
- Extra spaces are automatically removed
-
Email:
- Valid email format
- Unique in the system
- Automatically converted to lowercase
- Maximum 100 characters
-
Phone:
- Valid format (can include country code)
- Spaces and special characters are normalized
- Maximum 20 characters
-
Date of Birth:
- YYYY-MM-DD format
- Cannot be future date
- Configurable minimum age (default 13 years)
Business Validations
-
References:
- Agent, location and service IDs must exist and be active
- Time slot preferences must be valid
-
Custom Fields:
- Must match defined configuration
- Specific validations according to field type
-
Address:
- Country code must be valid (ISO 3166-1 alpha-2)
- Postal code must match country format
Recommended Flow
1. Pre-validation
2. Create Customer
3. Post-Creation Handling
Common Use Cases
1. Quick Registration during Booking
2. Full Registration with Account
3. Bulk Customer Import
Best Practices
1. Client-Side Validation
2. Robust Error Handling
3. Performance Optimization
Important Notes
Unique Email: The email must be unique throughout the system. If you try to create a customer with an existing email, you will receive a 409 error.
WordPress User: If you create an associated WordPress user, the customer will be able to access the customer area and manage their bookings.
