# Request a new account

Source: https://developer.avalara.com/account-provisioning/wzl5699124668524/

# Request a new account

**Element type:** Required

**Endpoints/models used:** [RequestNewAccount](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Provisioning/RequestNewAccount/)

Your integration must allow users to request a new account. You do this with the [RequestNewAccount](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Provisioning/RequestNewAccount/) endpoint.

The following table describes the fields that must be available to users who request a new account. These required fields and all optional fields are listed in the [NewAccountRequestModel](https://developer.avalara.com/api-reference/avatax/rest/v2/models/NewAccountRequestModel/) documentation.

**Field**

**Description**

`offer`

The offer code provided to you by your Avalara business development contact. This code controls what services and rates the customer will be provisioned with upon creation. If you don't know your offer code, contact your Avalara business development manager.

`accountName`

The name of the account to create. This value has a maximum length of 50 characters.

`firstName`

The first name of the primary contact for this account.

`lastName`

The last name of the primary contact for this account.

`email`

The email address of the primary contact for this account.

`companyAddress`

Address information for this account.

`haveReadAvalaraTermsAndConditions`

Specifies whether the owner of the newly created account has fully read Avalara's terms and conditions for your account. A license key is generated in the response if both this and `acceptAvalaraTermsAndConditions` are enabled.

`acceptAvalaraTermsAndConditions`

Specifies whether the owner of the newly created account accepts Avalara's terms and conditions for your account. A license key is generated in the response if both this and `haveReadAvalaraTermsAndConditions` are enabled.

## Example request

```
{
  "offer": "myoffercode",
  "connectorId": " ",
  "accountName": "AVATEST",
  "website": "https://biztech.com",
  "firstName": "Mac",
  "lastName": "Smith",
  "email": "mac.smith@avalara.com",
  "username": "mac.smith+AITest@avalara.com",
  "welcomeEmail": "Normal",
  "leadSource" : "",
  "campaign": "",
  "companyAddress": {
    "line": "10116 NE 8th St",
    "city": "Bellevue",
    "region": "WA",
    "country": "US",
    "postalCode": "98004"
  },
  "acceptAvalaraTermsAndConditions": true,
  "haveReadAvalaraTermsAndConditions": true
}
```

## Example response

The response returns information about the newly created account. It also includes a license key because both`acceptAvalaraTermsAndConditions` and`haveReadAvalaraTermsAndConditions` were`true` in the request.

```
{
  "accountId": 123456789,
  "licenseKey": "123ABC456DEF",
  "accountDetailsEmailedTo": "mac.smith@avalara.com",
  "createdDate": "2022-10-21T00:00:00",
  "emailedDate": "2022-10-21T00:00:00"
}
```