# Request a new entitlement

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

# Request a new entitlement

**Element type:** Required

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

Your integration must provide a way for users with existing accounts to add entitlements to their account. You do this with the [RequestNewEntitlement](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Provisioning/RequestNewEntitlement/) endpoint. When running this endpoint, include the existing account ID and the offer code in the request URL.

## Example request

```
curl -X 'POST' \
  'https://sandbox-rest.avatax.com/api/v2/accounts/123456789/entitlements/myoffer' \
  -H 'accept: application/json' \
  -H 'X-Avalara-Client: Swagger UI; 23.3.0; Custom; 1.0' \
  -H 'authorization: Basic YW5nZWxhLmJhcnR6QGF2YWxhcmEuY29tMTpBdnFsYXJhMHJhbmczIQ=='
```

## Example response

```
{
  "id": "1234567989",
  "offerMessage": "The offer myoffer has been added to the account 123456789 at 2023-02-28"
}
```