> This page is for Documentation, version Integration guides (default).
> For other versions, use one of these documentation indexes:
> - Integration guides (default): https://avalara.ferndocs.com/docs/integration-guides/llms.txt
> - Refactor guides: https://avalara.ferndocs.com/docs/refactor-guides/llms.txt
> - Get certified: https://avalara.ferndocs.com/docs/get-certified/llms.txt
> - Agent to Agent (A2A): https://avalara.ferndocs.com/docs/agent-to-agent-a2a/llms.txt
> - AI use cases: https://avalara.ferndocs.com/docs/ai-use-cases/llms.txt
> - API versioning: https://avalara.ferndocs.com/docs/api-versioning/llms.txt

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

# Customization

* [Previous](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/ts-pair-data/)
* [Next](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-configuration/)

### Set Tax Calculation Setting Request

The `SetTaxCalculationSettingRequest` object allows the user to specify **customization settings** for a client profile:

Key

Value

`ProfileConfigId`

`[int]` Profile Configuration Id

Profile configuration id to be used when updating an existing profile. Use `null` for a new configuration

`LinkProfileIds`

`[List<int>]` Link Profile Ids

Profile Id(s) to be added to the configuration. Use `null` to not change profiles associated with the configuration settings

`UnlinkProfileIds`

`[List<int>]` Unlink Profile Ids

Profile Id(s) to be removed from the configuration. Use `null` to not change profiles associated with the configuration settings

`ClientId`

`[int]` Client Id

Client Id associated with the configuration. Default Client Id for the current user is used if set to `null`

`Deactivate`

`[bool]` Deactivate

Indicates if the configuration should be deactivated. Automatically removes any profile mappings associated with the configuration

* `true`: Deactivate the configuration. Requires a valid ProfileConfigId to be provided
* `false`: Configuration isn't deactivated

`Description`

`[string]` Description

Description to be applied to requested configuration

`ReplaceExistingLinks`

`[bool]` Replace Existing Links

Indicates if the existing configuration links to the profile should be replaced. Only applies when one or more profiles have been specified to be linked.

* `true`: Replace existing links. Mapping conflicts are resolved by removing other links
* `false`: Don't replace existing links. Mapping conflicts cause the request to fail with an [error](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-error/) returned

`Settings`

[`[Configuration]`](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-configuration/) Tax Configuration Settings

Settings associated with a client profile configuration. May be associated with 0 to many profiles.

`Exclusions`

[`[ExclusionConfig]`](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-exclusion/) Exclusions

List of exclusions

`Bundles`

[`[BundleConfig]`](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-bundle/) Bundles

List of bundles

`Nexus`

[`[NexusConfig]`](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-nexus/) Nexus

List of nexus

`Overrides`

`[List<string>]` Overrides

List of lines contained in the override file

### Example

#### SetConfig Add Request Example

```json
{ "LinkProfileIds": [ 1, 2, 3 ], "ClientId": 999, "Deactivate": false, "Description": "Sample Add Config Description", "ReplaceExistingLinks": true, "Settings": { // Configuration }}
```

#### SetOverrides Update Request Example

```json
{ "ProfileConfigId": 1, "LinkProfileIds": [ 1, 2, 3 ], "UnlinkProfileIds": [ 4, 5, 6 ], "ClientId": 999, "Deactivate": false, "Description": "Sample Update Override Description", "ReplaceExistingLinks": true, "Overrides": [ "3.4", "1248900,1,3,3,3,1", "20180101,1", "0.123,2147483647,0,0,0,0", "19990401,1", "0.01125,2147483647,0,0,0,0", "19000101,1", "0.01,2147483647,0,0,0,0" ]}
```

* [Previous](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/ts-pair-data/)
* [Next](https://developer.avalara.com/communications/dev-guide_rest_v2/reference/customization-configuration/)

> **Note**
>
> Part of the **Communications REST v2 Developer Guide** integration guide. [Open the full "Customization" milestone on Avalara](https://developer.avalara.com/products/communications/integration-guides/dev-guide_rest_v2/reference/) to see every page in this section.