<!--
{
  "availability" : [
    "VPP License Management: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Client-Configuration",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:vpp:post:VPPClientConfigSrv"
  },
  "title" : "Client Configuration"
}
-->

# Client Configuration

Store client-specific information on the server.

## Discussion

### Example Request and Response

**Request:**

```
{
	"apnToken": null,
	"clientContext": "{\"guid\":\"b92\",\"hostname\":\"test.test.org\",\"ac2\":1}",
	"notificationToken": null,
	"notificationUrl": null,
	"sToken": "h40Gte9aQnZFDNM39IUkRPCsQDxBxbZB4Wy34pxefOuQkeeb3h2 a5Rlopo4KDn3MrFKf4CM3OY+WGAoZ1cD6iZ6yzsMk1+5PVBNc66YS6ZQ="
}
```

**Response:**

```json
{
  "appleId": "testuser1@test.org",
  "clientContext": "{\"guid\":\"b92\",\"hostname\":\"test.test.org\",\"ac2\":1}",
  "countryCode": "US",
  "defaultPlatform": "volumestore",
  "email": "testuser1@test.org",
  "expirationMillis": 1898103480266,
  "location": {
    "locationId": 22222222222,
    "locationName": "LocationName"
  },
  "organizationId": 2000000001630588,
  "organizationIdHash": "0420773fb70e423ef77916dee3b381987e6c3fb4d8f19d1fd071b0c48c0cd380",
  "status": 0,
  "uId": "103614"
}
```

### Example Request and Response with a Legacy Token

**Request:**

```
{
  "sToken": "h40Gte9aQnZFDNM39IUkRPCsQDxBxbZB4Wy34pxefOuQkeeb3h2 a5Rlopo4KDn3MrFKf4CM3OY+WGAoZ1cD6iZ6yzsMk1+5PVBNc66YS6ZQ="
}
```

**Response:**

```json
{
   "apnToken": "4IbRbXpge3ySkchugcf",
   "appleId": "test1@test.org",
   "clientContext": "{\"guid\":\"b92\",\"hostname\":\"test.test.org\",\"ac2\":1}",
   "countryCode": "US",
   "defaultPlatform": "volumestore",
   "email": "test1@test.org",
   "expirationMillis": 1850914593288,
   "organizationId": 2222222222,
   "organizationIdHash":"2555009cd3e53bd69b50723d2baec9f49558cbd90de2a1aa420dacdbff12cc8e",
   "status": 0,
   "uId": "100682"
}
```

## Topics

### Request and Response

[`object VppClientConfigRequest`](/documentation/DeviceManagement/VppClientConfigRequest)

The request for the client configuration.

[`object VppClientConfigResponse`](/documentation/DeviceManagement/VppClientConfigResponse)

The response that contains the client configuration.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)