Setup

Pre-requisites for enabling GDAP

In order to use GDAP with Work 365, following steps must be completed.

  1. Perform V2 consent of the Partner Center(s). This step is also required to continue the updated V2 billing api from Microsoft.
  2. Add the Partner Customer Delegated Administration service principal to the Partner Center tenant(s).

Perform V2 consent

For customers who are upgrading to Work 365 PV v2.0 and need to update their existing Microsoft Partner Center integrations to use the new consent process.

  1. Refer the article to setup Microsoft Partner Center integration.
  2. Confirm that the integration account is setup correctly as described in the above article.
  3. Complete the Admin Consent process described in Step 3a and the User Consent Step 3b above and then save the updated connector.
  4. Follow the steps under this video tutorial:

Add Partner Customer Delegated Administration service principal

In order to allow Work 365 to communicate with GDAP APIs, Microsoft requires that the Partner Customer Delegated Administration (with appId=2832473f-ec63-45fb-976f-5d45a7d4bb91) service principal exists in the Partner Center tenant.

  1. Open Microsoft Graph Explorer.
  2. Sign-in by clicking the user icon on the top right corner. Ensure that you are signing in with an account having Global Administrator privileges.
  3. Setup the graph explorer as follows. Do not click the Run Query button just yet!
  4. FieldValue
    MethodPOST
    versionv1.0
    URLhttps://graph.microsoft.com/v1.0/servicePrincipals
    Request Body{ "appId": "2832473f-ec63-45fb-976f-5d45a7d4bb91" }
  1. Click the Modify Permissions tab. Review the permissions listed and complete the consents requested.
  2. Click the Run Query button.
  3. If the request was successful, you should see a Created - 201 message.