---
title: "POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/createBillingRoleAssignment"
method: POST
path: "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/createBillingRoleAssignment"
tags: ["BillingRoleAssignments"]
---

# POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/createBillingRoleAssignment

`POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/createBillingRoleAssignment`

Adds a role assignment on a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.

## Path parameters

- `billingAccountName` string, required

## Query parameters

- `api-version` string, required

## Request body

- BillingRoleAssignmentPayload — The payload use to update role assignment on a scope
  - `principalId` string — The user's principal id that the role gets assigned to
  - `billingRoleDefinitionId` string — The role definition id

## Response `201`

Role assignment is successfully created

- BillingRoleAssignmentListResult — The list of role assignments.
  - `value` BillingRoleAssignment[] — The list of role assignments.
    - `id` string — Resource Id.
    - `name` string — Resource name.
    - `type` string — Resource type.
  - `nextLink` string — The link (url) to the next page of results.

## Other responses

- `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/versions/481e7355ac16/schema)