# Create an account

Endpoint: POST /v1/account
Version: 1.0.0_Beta

## Request fields (application/json):

  - `accountId` (string, required)
    Unique identifier of the account (short account name)
    Example: "12345"

  - `name` (string, required)
    Display name of the account (full account name)
    Example: "Flexera Software LLC"

  - `description` (string)
    Description of the account
    Example: "Flexera Software LLC - Main Office"

  - `address1` (string)
    First line of account's address
    Example: "123 Flexera St"

  - `address2` (string)
    Second line of account's address
    Example: "Suite 100"

  - `city` (string)
    City portion of account's address
    Example: "Chicago"

  - `state` (string)
    State portion of account's address
    Example: "IL"

  - `zipcode` (string)
    Zip/Postal code of the account's address
    Example: "60601"

  - `country` (string)
    Two-letter country code
    Example: "US"

  - `region` (string)
    Region in which this account's address exists
    Example: "North America"

  - `visible` (boolean)
    Applicable to CUSTOMER and CHANNEL_PARTNER accounts, visible determines whether or not an account unrelated to this account can see the name of this account when it is in a channel partner tier of an entitlement, line item, or device. If visible is false, this account will appear as Name Withheld to unrelated accounts. Default: true
    Example: true

  - `accountType` (string)
    Defines the account type. Valid values: CUSTOMER, PUBLISHER, CHANNEL_PARTNER Default: CUSTOMER. (Using REST API, a new account cannot be created with an accountType of SELF_REGISTERED.)
    Example: "CUSTOMER"

  - `attributes` (array)
    List of custom attributes attached to this account. Note that mandatory custom attributes must be included in this list

  - `attributes.name` (string)
    Name of the custom attribute
    Example: "REGION"

  - `attributes.value` (object)
    Value assigned to the custom attribute. Format and example depend on the type: 
- Single Text: "EMEA" 
- Multi-valued text: provide list of values between brackets [] delimited by , (e.g. ["Text1", "Text2"]) 
- Date: "YYYY/MM/DD" (e.g. "2025/12/31") 
- Number: 12345
    Example: "EMEA"

## Response 201 fields (application/json):

  - `status` (string)

## Response 400 fields (application/json):

  - `status` (string)

  - `message` (string)

## Response 409 fields (application/json):

  - `status` (string)

  - `message` (string)

## Response 500 fields (application/json):

  - `status` (string)

  - `message` (string)