> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Avalara Tax Engine settings

> Learn how to create, retrieve, and update the Avalara Tax Engines through the Settings API.

Learn how to create, retrieve, and update the Avalara Tax Engines through the Settings API.

## Create an Avalara Tax Engine

To create a new Avalara Tax Engine, see the following request and a sample of 200 response.

> **Note**
>
> The Create API can be used only once, as each tenant is limited to a single AvalaraTaxEngine.

HTTP request:

`POST https://rest.zuora.com/apps/settings/tax-engines/`

Request body:

```
curl --location 'https://rest.zuora.com/apps/settings/tax-engines/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <oauth token>' \
--data '{
  "name": "AvalaraTestEngine12",
  "taxEngineType": "Avalara",
  "accountNumber": "0981236784",
  "licenseKey": "B6GG780FP12FIMIRIH",
  "isTest": true
 }'
```

Response body:

```json
{
    "id": "4028818792d0c0550192d0e4c3af03ca",
    "name": "AvalaraTestEngine12",
    "taxEngineType": "Avalara",
    "accountNumber": "0981236784",
    "isTest": true,
    "username": null,
    "success": true
}
```

Supported fields:

* name: String
* taxEngineType: String (keep the value as "Avalara")
* accountNumber: String
* isTest: boolean
* licenseKey: String
* username: String
* password: String

## Get an Avalara Tax Engine

To get an Avalara Tax Engine, see the following request and a sample of 200 response.

`GET https://rest.zuora.com/settings/tax-engines/avalara/{id}`

Request body:

```
curl --location'https://rest.zuora.com/settings/tax-engines/avalara/{id}' \
--header 'Authorization: Bearer <oauth token>'
```

Response body:

```json
{
    "id": "40288186929d8a6a01929dbcaab67314",
    "name": "AvalaraTestEngine",
    "taxEngineType": "Avalara",
    "accountNumber": "6547894321",
    "isTest": true,
    "username": null,
    "success": true
}
```

## Update an Avalara Tax Engine

To update an Avalara Tax Engine, see the following request and a sample of 200 response.

HTTP request:

`PUT https://rest.zuora.com/settings/tax-engines/avalara/{id}`

Request body:

```
curl --location --request PUT 'https://rest.zuora.com/settings/tax-engines/avalara/{id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <oauth token>' \
--data '{ 
"name": "AvalaraTestEngine12",
"accountNumber": "0981236784",
"licenseKey": "B6GG780FP12FIMIRIH",
"isTest": true
 }'
```

Response body:

```json
{
    "id": "4028818792d0c0550192d0e4c3af03ca",
    "name": "AvalaraTestEngine12",
    "taxEngineType": "Avalara",
    "accountNumber": "0981236784",
    "isTest": true,
    "username": null,
    "success": true
}
```

Supported fields:

* name: String
* taxEngineType: String (keep the value as "Avalara")
* accountNumber: String
* isTest: boolean
* licenseKey: String
* username: String
* password: String

## Delete an Avalara Tax Engine

The Avalara Tax Engine does not support the Delete operation.