# Add a new content token (VPP token)

Add a new VPP content token to the MDM server for managing VPP accounts in Apple App Management.

## Endpoint

**POST** `/api/v1/mdm/apps/account/vpp`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/apps/account/vpp`

## Scope

`MDMDeviceMgmt.CREATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** `string` **Mandatory**: `application/json`
- **Accept** `string` **Mandatory**: `application/json`

### Request Body

`application/json`

- `vpp_token_file` `long` **Mandatory**
  - The unique ID of the server token file. Upload using [Upload File](https://www.manageengine.com/products/desktop-central/help/api/onpremise/files-upload-file-ems.html)
- `email_address` `string` **Mandatory**
  - Email ID added to receive notifications about the server token expiry date

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/apps/account/vpp \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"vpp_token_file":121313,"email_address":"sysadmin@zylker.com"}'
```

### Sample Request Body

Add a new VPP content token with notification email

```json
{
  "vpp_token_file": 121313,
  "email_address": "sysadmin@zylker.com"
}
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

- `location_name` `string`
  - Location name associated with the added content token
- `expired` `boolean`
  - Whether the content token has expired. false = active, true = expired
- `businessstore_id` `long`
  - Unique ID of the content token in the MDM system
- `organisation_name` `string`
  - Organization name associated with the content token
- `expiry_date` `long`
  - Epoch timestamp (milliseconds) when the content token expires

### Sample Response: HTTP 200

VPP account successfully added with token details

```json
{
  "location_name": "Location Name - 2",
  "expired": false,
  "expiry_date": 1639122831000,
  "businessstore_id": 9007199254741896,
  "organisation_name": "Zylker Inc"
}
```

## Possible Response Codes

- **200**: HTTP code

## Rate Limit

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.