Microsoft Partner Center (Preview)
This connector allows you to connect to MPC API and collect some information including customer details, orders and subscriptions.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | https://support.microsoft.com |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Privacy policy | https://privacy.microsoft.com/en-us/privacystatement |
| Categories | IT Operations;Business Management |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get All Customers |
Get a list of customers. |
| Get customer details |
Gets a Customer resource that corresponds to a customer ID. |
| Get customer orders |
Gets a collection of all the orders for a specified customer. |
| Get customer subscriptions |
Gets a collection of all the subscriptions for a specified customer. |
| Get invoices |
Get a collection of invoices. |
Get All Customers
Get a list of customers.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Size
|
Size | string |
The number of results to be displayed at one time. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Total Count
|
totalCount | integer |
Total count of elements in collection |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
The customer ID. |
|
Tenant ID
|
items.companyProfile.tenantId | string |
The customer's tenant identifier for Microsoft Entra ID. This is also called a MicrosoftID. |
|
Domain
|
items.companyProfile.domain | string |
The customer's name, such as contoso.onmicrosoft.com. |
|
Company Name
|
items.companyProfile.companyName | string |
The name of the company or organization. |
|
Relationship To Partner
|
items.relationshipToPartner | string |
Defines the licensing program that the partner uses for this customer: "none", "reseller", "advisor", "syndication" or "microsoft_support". |
Get customer details
Gets a Customer resource that corresponds to a customer ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Customer tenant ID
|
CustomerTenantID | True | string |
A customer tenant ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
The customer ID. |
|
The commerce ID.
|
commerceId | string |
The commerce ID. |
|
Tenant ID
|
companyProfile.tenantId | string |
The customer's tenant identifier for Microsoft Entra ID. This is also called a MicrosoftID. |
|
Company Name (Company Profile).
|
companyProfile.companyName | string |
The name of the company or organization. |
|
Domain
|
companyProfile.domain | string |
The customer's name, such as contoso.onmicrosoft.com. |
|
Country (Company Profile)
|
companyProfile.address.country | string |
The country. |
|
Region (Company Profile).
|
companyProfile.address.region | string |
The region. |
|
City (Company Profile)
|
companyProfile.address.city | string |
The city. |
|
State (Company Profile)
|
companyProfile.address.state | string |
The state. |
|
Address Line1 (Company Profile)
|
companyProfile.address.addressLine1 | string |
The first line of the address. |
|
Postal Code (Company Profile)
|
companyProfile.address.postalCode | string |
The ZIP code or postal code. |
|
Phone Number (Company Profile)
|
companyProfile.address.phoneNumber | string |
The phone number of a contact at the customer's company/organization. |
|
Email (Company Profile)
|
companyProfile.email | string |
Email. |
|
Profile ID
|
billingProfile.id | string |
The profile identifier. |
|
First Name (Billing Profile)
|
billingProfile.firstName | string |
The first name of the billing contact at the customer's company. |
|
Last Name (Billing Profile)
|
billingProfile.lastName | string |
The last name of the billing contact. |
|
Email (Billing Profile)
|
billingProfile.email | string |
The billing contact's email address |
|
Culture (Billing Profile)
|
billingProfile.culture | string |
Their preferred culture for communication and currency, such as "en-us". |
|
Language (Billing Profile)
|
billingProfile.language | string |
Their preferred language for communication. |
|
Company Name (Billing Profile)
|
billingProfile.companyName | string |
The name of the company or organization. |
|
Country (Billing Profile)
|
billingProfile.defaultAddress.country | string |
The country/region in ISO country code format. |
|
Region (Billing Profile)
|
billingProfile.defaultAddress.region | string |
The region. |
|
City (Billing Profile)
|
billingProfile.defaultAddress.city | string |
The city. |
|
State (Billing Profile)
|
billingProfile.defaultAddress.state | string |
The state. |
|
AddressLine1 (Billing Profile)
|
billingProfile.defaultAddress.addressLine1 | string |
The first line of the address. |
|
Postal Code (Billing Profile)
|
billingProfile.defaultAddress.postalCode | string |
The ZIP code or postal code. |
|
First Name (Billing Profile)
|
billingProfile.defaultAddress.firstName | string |
The first name of a contact at the customer's company/organization. |
|
Last Name (Billing Profile)
|
billingProfile.defaultAddress.lastName | string |
The last name of a contact at the customer's company/organization. |
|
Phone Number (Billing Profile)
|
billingProfile.defaultAddress.phoneNumber | string |
The phone number of a contact at the customer's company/organization. |
|
Relationship To Partner
|
relationshipToPartner | string |
Defines the licensing program that the partner uses for this customer: "none", "reseller", "advisor", "syndication" or "microsoft_support". |
|
Allow Delegated Access
|
allowDelegatedAccess | boolean |
Indicates whether the partner has been granted delegated admin privileges by this customer. |
|
Custom Domains
|
customDomains | array of string |
List of custom domains of a customer. |
Get customer orders
Gets a collection of all the orders for a specified customer.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Customer tenant ID
|
CustomerTenantID | True | string |
A customer tenant ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Total Count
|
totalCount | integer |
Total count of customer orders. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
An order identifier. |
|
Alternate ID
|
items.alternateId | string |
A friendly identifier for the order. |
|
Customer ID
|
items.referenceCustomerId | string |
The customer identifier. |
|
Billing Cycle
|
items.billingCycle | string |
Indicates the frequency with which the partner is billed for this order. |
|
Currency Code
|
items.currencyCode | string |
The currency used when placing the order. |
|
Currency Symbol
|
items.currencySymbol | string |
The currency symbol associated with the currency code. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
Line item number. |
|
Offer ID
|
items.lineItems.offerId | string |
The ID of the offer. |
|
Subscription ID
|
items.lineItems.subscriptionId | string |
The ID of the subscription. |
|
Term Duration
|
items.lineItems.termDuration | string |
An ISO 8601 representation of the term's duration. |
|
Promotion ID
|
items.lineItems.promotionId | string |
Promotion ID. |
|
Custom Term End Date
|
items.lineItems.customTermEndDate | string |
The end date of the first billing term of the new subscription. |
|
Transaction Type
|
items.lineItems.transactionType | string |
The transaction type of the line item. |
|
Friendly Name
|
items.lineItems.friendlyName | string |
The friendly name for the subscription defined by the partner to help disambiguate. |
|
quantity
|
items.lineItems.quantity | integer |
Quantity |
|
Creation Date
|
items.creationDate | string |
The date the order was created, in date-time format. |
|
Status
|
items.status | string |
The status of the order. |
|
Transaction Type
|
items.transactionType | string |
The transaction type of the order. Supported values are 'UserPurchase', 'SystemPurchase', or 'SystemBilling' |
Get customer subscriptions
Gets a collection of all the subscriptions for a specified customer.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Customer tenant ID
|
CustomerTenantID | True | string |
A customer's tenant ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Total Count
|
totalCount | integer |
Total count of subscriptions for customer. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
The subscription identifier. |
|
Offer ID
|
items.offerId | string |
The offer identifier. |
|
Offer Name
|
items.offerName | string |
The offer name. |
|
Friendly Name
|
items.friendlyName | string |
The friendly name for the subscription defined by the partner to help disambiguate. |
|
ID
|
items.productType.id | string |
The subscription identifier. |
|
Display Name
|
items.productType.displayName | string |
Display Name. |
|
Quantity
|
items.quantity | integer |
Provides the subscription quantity after provisioning. |
|
Unit Type
|
items.unitType | string |
The units defining quantity for the subscription. |
|
Has Purchasable Addons
|
items.hasPurchasableAddons | boolean |
A value indicating whether the subscription has purchasable add-ons. |
|
Creation Date
|
items.creationDate | string |
The creation date, in date-time format. |
|
Effective Start Date
|
items.effectiveStartDate | string |
The effective start date for this subscription, in date-time format. |
|
Commitment End Date
|
items.commitmentEndDate | string |
The commitment end date for this subscription, in date-time format. |
|
Cancellation Allowed Until Date
|
items.cancellationAllowedUntilDate | string |
The last date for cancellation. |
|
Billing Cycle End Date
|
items.billingCycleEndDate | string |
The billing cycle end date for this subscription, in date-time format. |
|
Status
|
items.status | string |
Indicates the provisioning status: "success", "pending" or "failed". |
|
Auto Renew Enabled
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Is Trial
|
items.isTrial | boolean |
A value indicating whether the subscription is a trial. |
|
Billing Type
|
items.billingType | string |
Specifies how the subscription is billed: "none", "usage", or "license". |
|
Billing Cycle
|
items.billingCycle | string |
Indicates the frequency with which the partner is billed for this order. |
|
Term Duration
|
items.termDuration | string |
An ISO 8601 representation of the term's duration. |
|
Renewal Term Duration
|
items.renewalTermDuration | string |
An ISO 8601 representation of the term's duration. |
|
Is Microsoft Product
|
items.isMicrosoftProduct | boolean |
A value indicating whether the subscription is a Microsoft product. |
|
Partner ID
|
items.partnerId | string |
The MPN ID of the reseller of record, used in the indirect partner model. |
|
Attention Needed
|
items.attentionNeeded | boolean |
Is Attention Needed. |
|
Contract Type
|
items.contractType | string |
The type of contract: "subscription", "productKey", or "redemptionCode". |
|
Publisher Name
|
items.publisherName | string |
The publisher name. |
|
Promotion ID
|
items.promotionId | string |
The promotion identifier if applied to the subscription. |
|
Order ID
|
items.orderId | string |
The ID of the order that was placed to begin the subscription. |
Get invoices
Get a collection of invoices.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Size
|
Size | integer |
The number of invoice resources to return in the response. This parameter is optional. |
|
|
Offset
|
Offset | string |
The zero-based index of the first invoice to return. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Total Count
|
totalCount | integer |
Total count of elements in the collection. |
|
items
|
items | array of object |
items |
|
ID
|
items.id | string |
The invoice identifier. |
|
Invoice Date
|
items.invoiceDate | string |
The date the invoice was generated. |
|
Billing Period Start Date
|
items.billingPeriodStartDate | string |
Billing period start date in UTC. |
|
Billing Period End Date
|
items.billingPeriodEndDate | string |
Billing period end date in UTC. |
|
Total Charges
|
items.totalCharges | float |
The total charges. Includes charges for transactions and any adjustments. |
|
Paid Amount
|
items.paidAmount | float |
The amount paid by the partner. Negative if a payment was received. |
|
Currency Code
|
items.currencyCode | string |
A code that indicates the currency used for all invoice item amounts and totals. |
|
Currency Symbol
|
items.currencySymbol | string |
The currency symbol used for all invoice item amounts and totals. |
|
PDF Download Link
|
items.pdfDownloadLink | string |
A link to download the invoice in PDF format. This link isn't returned as part of the search results, and is populated only if the invoice is accessed by ID. This link auto-expires in 30 minutes. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
The invoice details. |
|
Invoice Line Item Type
|
items.invoiceDetails.invoiceLineItemType | string |
The type of invoice detail: "none", "usage_line_items", "billing_line_items". |
|
Billing Provider
|
items.invoiceDetails.billingProvider | string |
The billing provider: "none", "office", "azure" or "azure_data_market". |
|
Document Type
|
items.documentType | string |
The document type of the invoice: "Credit Note", "Invoice". |
|
Invoice Type
|
items.invoiceType | string |
The type of invoice: "recurring", "one_time". |