> ## Documentation Index
> Fetch the complete documentation index at: https://alguna.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Account

<Snippet file="customer-request.mdx" />

## Request

<ParamField body="name" type="string" required>
  The name of the account.
</ParamField>

<ParamField body="aliases" type="[]string">
  The list of alternative or external IDs for the account. These can be used to
  identify the account in place of the Alguna `id`.
</ParamField>

<ParamField body="contacts" type="[]Contact">
  The contacts associated with the account.

  <Expandable title="properties">
    <ParamField body="email" type="string">
      The email address of the contact.
    </ParamField>

    <ParamField body="firstName" type="string">
      The first name of the contact.
    </ParamField>

    <ParamField body="lastName" type="string">
      The last name of the contact.
    </ParamField>

    <ParamField body="isPrimary" type="string">
      Whether the contact is the primary contact for the account.
    </ParamField>

    <ParamField body="emailPreferences" type="[]string">
      The email preferences for the contact. Valid values are `updates` and
      `billing`.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="billingAddress" type="Address">
  The billing address for the account.

  <Expandable title="properties">
    <ParamField body="line1" type="string" required>
      The first line of the address.
    </ParamField>

    <ParamField body="line2" type="string">
      The second line of the address.
    </ParamField>

    <ParamField body="city" type="string" required>
      The city of the address.
    </ParamField>

    <ParamField body="state" type="string" required>
      The state of the address.
    </ParamField>

    <ParamField body="postalCode" type="string" required>
      The postal code / zip code of the address.
    </ParamField>

    <ParamField body="country" type="string" required>
      The country of the address. This must be a valid ISO 3166-1 alpha-2
      country code.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="currency" type="string" required>
  The currency in which the account will be billed. This must be a valid ISO
  4217 currency code.
</ParamField>

## Response

<Snippet file="customer-response.mdx" />