Microsoft.Billing billingAccounts/billingProfiles template reference

Template format

To create a Microsoft.Billing/billingAccounts/billingProfiles resource, add the following JSON to the resources section of your template.

  "name": "string",
  "type": "Microsoft.Billing/billingAccounts/billingProfiles",
  "apiVersion": "2020-05-01",
  "properties": {
    "displayName": "string",
    "poNumber": "string",
    "billTo": {
      "firstName": "string",
      "lastName": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "addressLine3": "string",
      "city": "string",
      "district": "string",
      "region": "string",
      "country": "string",
      "postalCode": "string",
      "email": "string",
      "phoneNumber": "string"
    "invoiceEmailOptIn": "boolean",
    "enabledAzurePlans": [
        "skuId": "string"
    "invoiceSections": {
      "value": [
          "properties": {
            "displayName": "string",
            "labels": {}
  "resources": []

Property values

The following tables describe the values you need to set in the schema.

Microsoft.Billing/billingAccounts/billingProfiles object


In Bicep, type and apiVersion are specified in the first line of the resource declaration. Use the format <type>@<apiVersion>. Don't set those properties in the resource body.

Name Type Required Value
name string Yes The ID that uniquely identifies a billing profile.
type enum Yes For JSON -billingProfiles

See Set name and type for child resources.
apiVersion enum Yes For JSON - 2020-05-01
properties object Yes The properties of the billing profile. - BillingProfileProperties object
resources array No invoiceSections instructions

BillingProfileProperties object

Name Type Required Value
displayName string No The name of the billing profile.
poNumber string No The purchase order name that will appear on the invoices generated for the billing profile.
billTo object No Billing address. - AddressDetails object
invoiceEmailOptIn boolean No Flag controlling whether the invoices for the billing profile are sent through email.
enabledAzurePlans array No Information about the enabled azure plans. - AzurePlan object
invoiceSections object No The invoice sections associated to the billing profile. By default this is not populated, unless it's specified in $expand. - InvoiceSectionsOnExpand object

AddressDetails object

Name Type Required Value
firstName string No First name.
lastName string No Last name.
companyName string No Company name.
addressLine1 string Yes Address line 1.
addressLine2 string No Address line 2.
addressLine3 string No Address line 3.
city string No Address city.
district string No Address district.
region string No Address region.
country string Yes Country code uses ISO2, 2-digit format.
postalCode string No Postal code.
email string No Email address.
phoneNumber string No Phone number.

AzurePlan object

Name Type Required Value
skuId string No The sku id.

InvoiceSectionsOnExpand object

Name Type Required Value
value array No The invoice sections associated to the billing profile. - InvoiceSection object

InvoiceSection object

Name Type Required Value
properties object No The properties of an invoice section. - InvoiceSectionProperties object

InvoiceSectionProperties object

Name Type Required Value
displayName string No The name of the invoice section.
labels object No Dictionary of metadata associated with the invoice section.