When creating a subaccount, the current authenticated user must have thebilling.accounts.updateIAM permission on the parent account, which is typically given to billing accountadministrators. 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
[[["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-09-04 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,["# Method: organizations.billingAccounts.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nThis method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts).\n\nGoogle Cloud resellers should use the Channel Services APIs, [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).\n\nWhen 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](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.\n\n### HTTP request\n\n`POST https://cloudbilling.googleapis.com/v1/{parent=organizations/*}/billingAccounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [BillingAccount](/billing/docs/reference/rest/v1/billingAccounts#BillingAccount).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [BillingAccount](/billing/docs/reference/rest/v1/billingAccounts#BillingAccount).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-billing`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
