Partner Center submission API to onboard Azure apps in Partner Center
Use the Partner Center submission API to programmatically query, create submissions for, and publish Azure offers. This API is useful if your account manages many offers and you want to automate and optimize the submission process for these offers.
There are a few programmatic assets that you need in order to use the Partner Center API for Azure Products:
- an Azure Active Directory application.
- an Azure Active Directory (Azure AD) access token.
Step 1: Complete prerequisites for using the Partner Center submission API
Before you start writing code to call the Partner Center submission API, make sure that you have completed the following prerequisites.
You (or your organization) must have an Azure AD directory and you must have Global administrator permission for the directory. If you already use Microsoft 365 or other business services from Microsoft, you already have Azure AD directory. Otherwise, you can create a new Azure AD in Partner Center at no additional charge.
You must associate an Azure AD application with your Partner Center account and obtain your tenant ID, client ID and key. You need these values to obtain an Azure AD access token, which you will use in calls to the Microsoft Store submission API.
How to associate an Azure AD application with your Partner Center account
To use the Microsoft Store submission API, you must associate an Azure AD application with your Partner Center account, retrieve the tenant ID and client ID for the application, and generate a key. The Azure AD application represents the app or service from which you want to call the Partner Center submission API. You need the tenant ID, client ID and key to obtain an Azure AD access token that you pass to the API.
You only need to perform this task once. After you have the tenant ID, client ID and key, you can reuse them any time you need to create a new Azure AD access token.
- In Partner Center, associate your organization's Partner Center account with your organization's Azure AD directory.
- Next, from the Users page in the Account settings section of Partner Center, add the Azure AD application that represents the app or service that you will use to access submissions for your Partner Center account. Make sure you assign this application the Manager role. If the application doesn't exist yet in your Azure AD directory, you can create a new Azure AD application in Partner Center.
- Return to the Users page, click the name of your Azure AD application to go to the application settings, and copy down the Tenant ID and Client ID values.
- Click Add new key. On the following screen, copy down the Key value. You won't be able to access this info again after you leave this page. For more information, see Manage keys for an Azure AD application.
Step 2: Obtain an Azure AD access token
Before you call any of the methods in the Partner Center submission API, you must first obtain an Azure AD access token that you pass to the Authorization header of each method in the API. After you obtain an access token, you have 60 minutes to use it before it expires. After the token expires, you can refresh the token so you can continue to use it in future calls to the API.
To obtain the access token, follow the instructions in Service to Service Calls Using Client Credentials to send an
HTTP POST to the
https://login.microsoftonline.com/<tenant_id>/oauth2/token endpoint. Here is a sample request:
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1 Host: login.microsoftonline.com Content-Type: application/x-www-form-urlencoded; charset=utf-8 grant_type=client_credentials &client_id=<your_client_id> &client_secret=<your_client_secret> &resource= https://api.partner.microsoft.com
For the tenant_id value in the
POST URI and the client_id and client_secret parameters, specify the tenant ID, client ID and the key for your application that you retrieved from Partner Center in the previous section. For the resource parameter, you must specify
Step 3: Use the Microsoft Store submission API
After you have an Azure AD access token, you can call methods in the Partner Center submission API. To create or update submissions, you typically call multiple methods in the Partner Center submission API in a specific order. For information about each scenario and the syntax of each method, see the Ingestion API swagger.