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=billingAccounts/*}/subAccounts
[[["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 facilitates the creation of billing subaccounts within Google Cloud.\u003c/p\u003e\n"],["\u003cp\u003eResellers should utilize the Channel Services APIs instead of this method for creating subaccounts.\u003c/p\u003e\n"],["\u003cp\u003eThe authenticated user needs the \u003ccode\u003ebilling.accounts.update\u003c/code\u003e IAM permission on the parent account to create a subaccount.\u003c/p\u003e\n"],["\u003cp\u003eThe request is sent as an HTTP POST to a specific URL, including a \u003ccode\u003eparent\u003c/code\u003e parameter for identifying the parent billing account.\u003c/p\u003e\n"],["\u003cp\u003eBoth the request and successful response bodies contain instances of the \u003ccode\u003eBillingAccount\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: billingAccounts.subAccounts.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=billingAccounts/*}/subAccounts`\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/)."]]
