Create a new customer
POST/v2/customers
Creates a new customer with the provided information. The customer can be associated with a parent company and includes personal details, contact information, and preferences.
Key Features:
- Supports multiple address types (billing, shipping, residential)
- Automatic source tracking for external system integration
- Flexible attribute system for custom data
- Built-in validation for email formats and required fields
Business Rules:
- Email addresses must be unique across the system
- At least one contact method (email, phone, or mobile) is recommended
- Source information is required for external system integration
- Addresses are validated for completeness and format
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 500
Entity created successfully with all provided information
Invalid request data or validation errors
Authentication required - provide valid OAuth2 token
Insufficient permissions - requires customers:write scope
Entity already exists with the provided identifiers
Internal server error occurred during customer creation