Customer resources

  • Article

Applies to: Partner Center | Partner Center operated by 21Vianet | Partner Center for Microsoft Cloud for US Government

Customer

The Customer resource represents a customer or reseller. Most broadly, a customer resource can be any person, employee, or organization that wishes to do business with Microsoft and Microsoft's resellers. Customers also have a company profile and a billing profile.

Note

The Customer resource has a rate limit of 500 requests per minute per tenant identifier.

Property Type Description
ID string The customer ID.
commerceID string The commerce ID.
companyProfile CustomerCompanyProfile Additional information about the company or organization.
billingProfile CustomerBillingProfile Additional information used for billing.
relationshipToPartner string Defines the licensing program that the partner uses for this customer: none, reseller, advisor, syndication or microsoft\_support.
allowDelegatedAccess boolean Indicates whether the partner has been granted delegated admin privileges by this customer. This property is only available when getting a customer by ID, not by list.
userCredentials UserCredentials The user credentials.
customDomains array of strings List of custom domains of a customer.
associatedPartnerID string The indirect reseller associated to this customer account. This value can be set only by indirect CSP partners.
links ResourceLinks The resource links contained within the profile.
attributes ResourceAttributes The metadata attributes corresponding to the profile.

CustomerCompanyProfile

The CustomerCompanyProfile resource is additional information about the company or organization.

Property Type Description
tenantID string The customer's tenant identifier for Microsoft Entra ID. This is also called a MicrosoftID.
domain string The customer's name, such as contoso.onmicrosoft.com.
companyName string The name of the company or organization.
links ResourceLinks The resource links contained within the profile.
attributes ResourceAttributes The metadata attributes corresponding to the profile.
organizationRegistrationNumber String The customer's organization registration number (also referred to as INN number in certain countries/regions). Only required for customer's company/organization located in the following countries/regions: Armenia(AM), Azerbaijan(AZ), Belarus(BY), Hungary(HU), Kazakhstan(KZ), Kyrgyzstan(KG), Moldova(MD), Russia(RU), Tajikistan(TJ), Uzbekistan(UZ), Ukraine(UA), India, Brazil, South Africa, Poland, United Arab Emirates, Saudi Arabia, Türkiye, Thailand, Vietnam, Myanmar, Iraq, South Sudan, and Venezuela. For customer's company/organization located in other countries/regions, this shouldn't be specified.

CustomerBillingProfile

The CustomerBillingProfile resource is additional information used to bill the customer.

Property Type Description
ID string The profile identifier.
firstName string The first name of the billing contact at the customer's company. This is the person that invoices and other billing communication is directed to.
lastName string The last name of the billing contact.
email string The billing contact's email address
culture string Their preferred culture for communication and currency, such as en-us.
language string Their preferred language for communication.
companyName string The name of the company or organization.
defaultAddress Address The address that bills are sent to, where the billing contact works.
links ResourceLinks The resource links contained within the profile.
attributes ResourceAttributes The metadata attributes corresponding to the profile.

CustomerRelationshipRequest

The CustomerRelationshipRequest resource contains the URL used by the customer to establish a reseller relationship with a partner.

Property Type Description
url string The URL used by the customer to establish a relationship with a partner.
attributes ResourceAttributes The metadata attributes corresponding to the relationship request.