Skip to main content

customerCreate

Create a new customer account with complete validation and business rule enforcement.

Key Features​

  • Complete Validation: Validates all customer data including email format, field lengths, and business rules
  • Unique Constraints: Ensures email and debtor ID uniqueness across the system
  • Source Tracking: Supports external system integration with source identification
  • Address Management: Allows creation of multiple addresses during customer setup

Business Rules​

  • Email address must be unique across all customers
  • Debtor ID must be unique if provided
  • First name and last name are required fields
  • Email format validation is enforced
  • Field length limits are enforced (firstName: 30 chars, lastName: 50 chars, etc.)

Validation Rules​

  • firstName: Maximum 30 characters, HTML tags removed
  • lastName: Maximum 50 characters, HTML tags removed
  • middleName: Maximum 20 characters, HTML tags removed
  • email: Valid email format, maximum 150 characters, HTML tags removed
  • phone/mobile: Maximum 30 characters, HTML tags removed
  • debtorId: Maximum 30 characters
  • primaryLanguage: Exactly 2 characters (ISO language code)
  • dateOfBirth: Valid date string in YYYY-MM-DD format

Error Scenarios​

  • CUSTOMER_ALREADY_EXISTS_ERROR: Customer with the same email or debtor ID already exists
  • CUSTOMER_CREATE_ERROR: System error occurred during customer creation
  • CUSTOMER_BULK_VALIDATION_ERROR: Validation errors in customer data

Use Cases​

  • New customer onboarding
  • Customer data import from external systems
  • Administrative customer creation
  • Customer account setup without login credentials

Note: For customers that need login access, use customerRegister instead.

AUTH: Role=[user.OWNER]

customerCreate(
  input: CustomerInput!
): Customer!

Arguments​

customerCreate.input ● CustomerInput! non-null input​

Complete customer creation data with validation and business rules

Type​

Customer object​

Customer entity representing individual customers and end users.

External entity from the customer service that provides customer identification and profile information. Used as a reference for customer-specific attributes and personalization features within the attribute system.