# Create a new account

Creates a new customer account with billing address and primary contact information

Endpoint: POST /hero-api/v1/accounts
Version: 1.0.0
Security: apiKey

## Request fields (application/json):

  - `accountName` (string, required)
    Name of the account/company
    Example: Acme Corporation

  - `billingAddress` (object)

  - `billingAddress.street` (string)
    Example: 123 Main St

  - `billingAddress.unit` (string)
    Example: Suite 100

  - `billingAddress.city` (string)
    Example: San Francisco

  - `billingAddress.state` (string)
    Example: CA

  - `billingAddress.country` (string)
    Example: USA

  - `billingAddress.zip` (string)
    Example: 94105

  - `primaryContact` (object)

  - `primaryContact.firstName` (string)
    Example: John

  - `primaryContact.lastName` (string)
    Example: Doe

  - `primaryContact.email` (string)
    Example: john.doe@acme.com

  - `primaryContact.phone` (string)
    Example: +1-555-0123

## Response 200 fields (application/json):

  - `accountId` (string)
    Unique identifier for the account (auto-generated)
    Example: acc-789xyz

  - `accountNumber` (string)
    Unique account number (auto-generated)
    Example: ACC-2024-0001

  - `accountName` (string, required)
    Name of the account/company
    Example: Acme Corporation

  - `billingAddress` (object)

  - `billingAddress.addressId` (string)
    Unique identifier for the address (auto-generated)
    Example: addr-123

  - `billingAddress.street` (string)
    Example: 123 Main St

  - `billingAddress.unit` (string)
    Example: Suite 100

  - `billingAddress.city` (string)
    Example: San Francisco

  - `billingAddress.state` (string)
    Example: CA

  - `billingAddress.country` (string)
    Example: USA

  - `billingAddress.zip` (string)
    Example: 94105

  - `primaryContact` (object)

  - `primaryContact.contactId` (string)
    Unique identifier for the contact (auto-generated)
    Example: cont-456

  - `primaryContact.firstName` (string)
    Example: John

  - `primaryContact.lastName` (string)
    Example: Doe

  - `primaryContact.email` (string)
    Example: john.doe@acme.com

  - `primaryContact.phone` (string)
    Example: +1-555-0123