---
title: "PATCH /providers/Microsoft.Billing/billingAccounts/{billingAccountName}"
method: PATCH
path: "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}"
tags: ["BillingAccounts"]
---

# PATCH /providers/Microsoft.Billing/billingAccounts/{billingAccountName}

`PATCH /providers/Microsoft.Billing/billingAccounts/{billingAccountName}`

Updates the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

## Path parameters

- `billingAccountName` string, required

## Query parameters

- `api-version` string, required

## Request body

- BillingAccountUpdateRequest — The request properties of the billing account that can be updated.
  - `properties` BillingAccountProperties — The properties of the billing account.
    - `displayName` string — The billing account name.
    - `address` AddressDetails — Address details.
      - `firstName` string — First name.
      - `lastName` string — Last name.
      - `companyName` string — Company name.
      - `addressLine1` string — Address line 1.
      - `addressLine2` string — Address line 2.
      - `addressLine3` string — Address line 3.
      - `city` string — Address city.
      - `region` string — Address region.
      - `country` string — Country code uses ISO2, 2-digit format.
      - `postalCode` string — Postal code.
    - `agreementType` 'MicrosoftCustomerAgreement' | 'EnterpriseAgreement' | 'MicrosoftOnlineServicesProgram' | 'MicrosoftPartnerAgreement' — The type of agreement.
    - `customerType` 'Enterprise' | 'Individual' | 'Partner' — The type of customer.
    - `accountType` 'Enterprise' | 'Individual' | 'Partner' — The type of customer.
    - `billingProfiles` BillingProfile[] — The billing profiles associated with the billing account. By default this is not populated, unless it's specified in $expand.
      - `id` string — Resource Id.
      - `name` string — Resource name.
      - `type` string — Resource type.
    - `enrollmentDetails` Enrollment — The properties of an enrollment.
      - `startDate` string, date-time — The start date of the enrollment.
      - `endDate` string, date-time — The end date of the enrollment.
      - `currency` string — The billing currency for the enrollment.
      - `channel` string — The channel type of the enrollment.
      - `policies` EnrollmentPolicies — The policies for Enterprise Agreement enrollments.
        - `accountOwnerViewCharges` boolean — The policy that controls whether Account Owners can view charges.
        - `departmentAdminViewCharges` boolean — The policy that controls whether Department Administrators can view charges.
        - `marketplacesEnabled` boolean — The policy that controls whether Azure marketplace purchases are allowed in the enrollment.
        - `reservedInstancesEnabled` boolean — The policy that controls whether Azure reservation purchases are allowed in the enrollment.
      - `language` string — The language for the enrollment.
      - `countryCode` string — The country code of the enrollment.
      - `status` string — The current status of the enrollment.
      - `billingCycle` string — The billing cycle for the enrollment.
    - `departments` Department[] — The departments associated to the enrollment.
      - `id` string — Resource Id.
      - `name` string — Resource name.
      - `type` string — Resource type.
    - `enrollmentAccounts` EnrollmentAccount[] — The accounts associated to the enrollment.
      - `id` string — Resource Id.
      - `name` string — Resource name.
      - `type` string — Resource type.
    - `organizationId` string — Organization id.

## Response `200`

OK. The request has succeeded.

- BillingAccount — The Resource model definition.
  - `id` string — Resource Id.
  - `name` string — Resource name.
  - `type` string — Resource type.

## Other responses

- `202` — Accepted. Billing account update is in progress.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/billingmanagementclient.md) · [All operations](https://skmtc.net/azure/apis/billingmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/billingmanagementclient/revisions/481e7355ac16/schema)