When creating a subaccount, the current authenticated user must have the billing.accounts.update IAM permission on the parent account, which is typically given to billing account administrators. This method will return an error if the parent account has not been provisioned for subaccounts.
HTTP request
POST https://cloudbilling.googleapis.com/v1/{parent=organizations/*}/billingAccounts
Optional. The parent to create a billing account from. Format: - billingAccounts/{billing_account_id}, for example, billingAccounts/012345-567890-ABCDEF
Request body
The request body contains an instance of BillingAccount.
Response body
If successful, the response body contains a newly created instance of BillingAccount.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-14 UTC."],[[["This method allows the creation of billing subaccounts within the Google Cloud platform, as detailed in the [billing subaccounts documentation](https://cloud.google.com/billing/docs/concepts#subaccounts)."],["Google Cloud resellers should instead utilize the Channel Services APIs, specifically the [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create) methods."],["To successfully create a subaccount, the user must possess the `billing.accounts.update` IAM permission on the parent account, typically held by billing account administrators, as described in the [billing access documentation](https://cloud.google.com/billing/docs/how-to/billing-access)."],["The HTTP request is a POST method to `https://cloudbilling.googleapis.com/v1/{parent=organizations/*}/billingAccounts`, and you can set the `parent` parameter in the URL to assign the account to an existing billing account."],["The request body requires an instance of `BillingAccount`, and a successful response will include a newly created instance of `BillingAccount`."]]],[]]
