# 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"


## Response 400 fields

## Response 401 fields

## Response 409 fields