---
title: "customerAddTaxExemptions"
description: "Add tax exemption information for customers."
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/customers/mutations/customer-add-tax-exemptions'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/customers/mutations/customer-add-tax-exemptions.md'
---
# customerAddTaxExemptions

Add tax exemption information for customers.

- **Required Scopes:** `write_customers`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`CustomerAddTaxExemptionsPayload`

## Required Permissions

* `write_customers`

An access token is required to call this API. Refer to [Authorization](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md) for more information about how to obtain the token.

## Arguments

* `customerId`

  [ID!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/id.md)

  customer ID

* `taxExemptions`

  [[FreeAreasInput!]](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/inputs/free-areas-input.md)

  Duty free area for customers

## Returns

* `customer`

  [Customer](https://developer.shopline.com/docs/admin-graph-ql-api/customers/objects/customer.md)

  The updated customer.

* `userErrors`

  [[BusinessCustomerUserError]](https://developer.shopline.com/docs/admin-graph-ql-api/customers/objects/business-customer-user-error.md)

  error message

## Code Example

```graphql
mutation customerAddTaxExemptions($customerId: ID! $taxExemptions: [FreeAreasInput!] ) {
	customerAddTaxExemptions(customerId: $customerId, taxExemptions: $taxExemptions ) 
		 {
			# CustomerAddTaxExemptionsPayload fields
		}
		
	}

```

## Variables

```json
{
  "customerId": {},
  "taxExemptions": {
    "countryCode": {},
    "provinceGCodeList": {}
  }
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes).