Share via


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".