# Identity create

Low level identity onboarding

Endpoint: POST /eapi/v0/identities/basic
Version: 0 BETA
Security: HMACAuth

## Request fields (application/json):

  - `identityReference` (string, required)
    ASCII letters, digits, and hyphen only, A unique customer identifier provided by you. This field is required and must be unique for each customer. Please ensure you consistently reuse the same identityReference for repeat interactions with the same customer, allowing us to reliably recognize and associate their identity.
    Example: "c-13344"

  - `givenName` (string)
    Company representative first name.
    Example: "Joe"

  - `surname` (string)
    Company representative last name.
    Example: "Bloggs"

  - `dateOfBirth` (string)
    Date of birth in YYYY-MM-DD format. Must be a past date.
    Example: "1990-05-21"

  - `email` (string)
    Email address of the customer.
    Example: "test@solana.com.au"

  - `residentialAddress` (object)

  - `residentialAddress.addressLine` (string, required)
    Street address.
    Example: "44 Gwynne Street"

  - `residentialAddress.suburb` (string, required)
    Suburb of the address.
    Example: "Cremorne"

  - `residentialAddress.state` (string, required)
    State or region, required when country is US.
    Example: "VIC"

  - `residentialAddress.postCode` (string, required)
    Postal code.
    Example: "3121"

  - `residentialAddress.country` (string, required)
    Country code.
    Example: "AU"

## Response 201 fields (application/json):

  - `identityReference` (string, required)
    ASCII letters, digits, and hyphen only, A unique customer identifier provided by you. This field is required and must be unique for each customer. Please ensure you consistently reuse the same identityReference for repeat interactions with the same customer, allowing us to reliably recognize and associate their identity.
    Example: "c-13344"

  - `createdAt` (string, required)
    The UTC date time of the identity.
    Example: "2023-06-05T19:53:08.320Z"

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Bad Request"

  - `status` (integer)
    Example: 400

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

  - `status` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `message` (string)
    Example: "Not Found"

  - `status` (integer)
    Example: 404

## Response 422 fields (application/json):

  - `message` (string)
    Example: "The given data was invalid."

  - `errors` (object)

  - `status` (integer)
    Example: 422

## Response 429 fields (application/json):

  - `message` (string)
    Example: "Too Many Requests. Please try again later."

  - `status` (integer)
    Example: 429