Create iosVppApp
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Create a new iosVppApp object.
Prerequisites
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from most to least privileged) |
---|---|
Delegated (work or school account) | DeviceManagementApps.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Not supported. |
HTTP Request
POST /deviceAppManagement/mobileApps
Request headers
Header | Value |
---|---|
Authorization | Bearer <token> Required. |
Accept | application/json |
Request body
In the request body, supply a JSON representation for the iosVppApp object.
The following table shows the properties that are required when you create the iosVppApp.
Property | Type | Description |
---|---|---|
id | String | Key of the entity. Inherited from mobileApp |
displayName | String | The admin provided or imported title of the app. Inherited from mobileApp |
description | String | The description of the app. Inherited from mobileApp |
publisher | String | The publisher of the app. Inherited from mobileApp |
largeIcon | mimeContent | The large icon, to be displayed in the app details and used for upload of the icon. Inherited from mobileApp |
createdDateTime | DateTimeOffset | The date and time the app was created. Inherited from mobileApp |
lastModifiedDateTime | DateTimeOffset | The date and time the app was last modified. Inherited from mobileApp |
isFeatured | Boolean | The value indicating whether the app is marked as featured by the admin. Inherited from mobileApp |
privacyInformationUrl | String | The privacy statement Url. Inherited from mobileApp |
informationUrl | String | The more information Url. Inherited from mobileApp |
owner | String | The owner of the app. Inherited from mobileApp |
developer | String | The developer of the app. Inherited from mobileApp |
notes | String | Notes for the app. Inherited from mobileApp |
publishingState | mobileAppPublishingState | The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from mobileApp. Possible values are: notPublished , processing , published . |
usedLicenseCount | Int32 | The number of VPP licenses in use. |
totalLicenseCount | Int32 | The total number of VPP licenses. |
releaseDateTime | DateTimeOffset | The VPP application release date and time. |
appStoreUrl | String | The store URL. |
licensingType | vppLicensingType | The supported License Type. |
applicableDeviceType | iosDeviceType | The applicable iOS Device Type. |
vppTokenOrganizationName | String | The organization associated with the Apple Volume Purchase Program Token |
vppTokenAccountType | vppTokenAccountType | The type of volume purchase program which the given Apple Volume Purchase Program Token is associated with. Possible values are: business , education . Possible values are: business , education . |
vppTokenAppleId | String | The Apple Id associated with the given Apple Volume Purchase Program Token. |
bundleId | String | The Identity Name. |
Response
If successful, this method returns a 201 Created
response code and a iosVppApp object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1222
{
"@odata.type": "#microsoft.graph.iosVppApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"publishingState": "processing",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value"
}
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1394
{
"@odata.type": "#microsoft.graph.iosVppApp",
"id": "a0ac9b6f-9b6f-a0ac-6f9b-aca06f9baca0",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"publishingState": "processing",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value"
}
Feedback
Loading feedback...