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."],[[["\u003cp\u003eThis method allows the creation of billing subaccounts within the Google Cloud platform, as detailed in the \u003ca href=\"https://cloud.google.com/billing/docs/concepts#subaccounts\"\u003ebilling subaccounts documentation\u003c/a\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud resellers should instead utilize the Channel Services APIs, specifically the \u003ca href=\"https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create\"\u003eaccounts.customers.create\u003c/a\u003e and \u003ca href=\"https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create\"\u003eaccounts.customers.entitlements.create\u003c/a\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eTo successfully create a subaccount, the user must possess the \u003ccode\u003ebilling.accounts.update\u003c/code\u003e IAM permission on the parent account, typically held by billing account administrators, as described in the \u003ca href=\"https://cloud.google.com/billing/docs/how-to/billing-access\"\u003ebilling access documentation\u003c/a\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a POST method to \u003ccode\u003ehttps://cloudbilling.googleapis.com/v1/{parent=organizations/*}/billingAccounts\u003c/code\u003e, and you can set the \u003ccode\u003eparent\u003c/code\u003e parameter in the URL to assign the account to an existing billing account.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires an instance of \u003ccode\u003eBillingAccount\u003c/code\u003e, and a successful response will include a newly created instance of \u003ccode\u003eBillingAccount\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
