To see an example of how to include query parameters in a request, see the
JSON API Overview page.
Parameters
Parameter name
Value
Description
Path parameters
bucket
string
The parent bucket of the folder.
Optional query parameters
recursive
boolean
If set to true, the method creates all the non-existing parent folders. If not set or set to false,
the request fails if any parent folder doesn't exist.
Request body
In the request body, supply a folder
resource with the following properties:
Property name
Value
Description
Required Properties
name
string
The name of the folder.
Response
If successful, this method returns a
Folder resource in the response body.
For information about status and error codes returned by this API, see the
reference page.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
[[["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-08-07 UTC."],[],[],null,["# Folder: insert\n\nCreates a [folder](/storage/docs/folders-overview) within a bucket with hierarchical namespace enabled.\n\nRequired permissions\n--------------------\n\nThe authenticated user must have the `storage.folders.create`\nIAM permission to use this method.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://storage.googleapis.com/storage/v1/b/bucket/folders\n```\n\nIn addition to [standard query parameters](/storage/docs/json_api/v1/parameters#query),\nthe following parameters apply to this method.\n\nTo see an example of how to include query parameters in a request, see the\n[JSON API Overview](/storage/docs/json_api#query_parameters) page.\n\n### Parameters\n\n### Request body\n\nIn the request body, supply a [folder\nresource](/storage/docs/json_api/v1/folders#resource) with the following properties:\n\nResponse\n--------\n\nIf successful, this method returns a\n[Folder resource](/storage/docs/json_api/v1/folders#resource) in the response body.\n\nFor information about status and error codes returned by this API, see the\n[reference page](/storage/docs/json_api/v1/status-codes).\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
