# Create a new account

Create a new TickeTing user account. Most user data is optional for
account creation, so there is flexibility in the stage of the
onboarding process at which data is captured.

Endpoint: POST /accounts
Version: 3.0.0
Security: SessionKey

## Request fields (application/json):

  - `username` (string, required)
    Unique username attached to the account

  - `password` (string, required)
    The password of the account starting the session

  - `email` (string, required)
    Unique email address attached to the account

  - `firstName` (string)
    The account holder's forename

  - `lastName` (string)
    The account holder's surname

  - `title` (string)
    The account holder's formal title
    Enum: "Mr", "Mrs", "Ms", "Mx"

  - `dateOfBirth` (string)
    The account holder's date of birth

  - `phone` (string)
    The account holder's primary contact number

  - `country` (string)
    The country associated with the account (used for regionalisation)

  - `firstAddressLine` (string)
    The first line of the account holder's address

  - `secondAddressLine` (string)
    The second line of the account holder's address

  - `city` (string)
    The city portion of the account holder's address

  - `state` (string)
    The state, parish or district portion of the account holder's address

## Response 201 fields (application/json):

  - `self` (string)
    URI of the account resource

  - `number` (string)
    Immutable identifier attached to the account

  - `username` (string)
    Unique username attached to the account

  - `email` (string)
    Unique email address attached to the account

  - `role` (string)
    User role assigned to the account
    Enum: "customer", "support", "host", "administrator"

  - `verified` (boolean)
    True if the account email address has been verified, false otherwise

  - `activated` (boolean)
    True if the account is active, false if it has been deactivated

  - `firstName` (string)
    The account holder's forename

  - `lastName` (string)
    The account holder's surname

  - `title` (string)
    The account holder's formal title
    Enum: "Mr", "Mrs", "Ms", "Mx"

  - `dateOfBirth` (string)
    The account holder's date of birth

  - `phone` (string)
    The account holder's primary contact number

  - `country` (string)
    The country associated with the account (used for regionalisation)

  - `firstAddressLine` (string)
    The first line of the account holder's address

  - `secondAddressLine` (string)
    The second line of the account holder's address

  - `city` (string)
    The city portion of the account holder's address

  - `state` (string)
    The state, parish or district portion of the account holder's address

  - `preferences` (string)
    URI of the account's user preferences resource

## Response 400 fields (application/json):

  - `message` (string)
    Reason for the given response.

## Response 409 fields (application/json):

  - `message` (string)
    Reason for the given response.