Drives: insert

Stay organized with collections Save and categorize content based on your preferences.

Creates a new shared drive. Try it now.


HTTP request



Parameter name Value Description
Required query parameters
requestId string An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned.


This request requires authorization with the following scope:


Some scopes are restricted and require a security assessment for your app to use them. For more information, see the authentication and authorization page.

Request body

In the request body, supply a Drives resource with the following properties:

Property name Value Description Notes
Required Properties
name string The name of this shared drive. writable
Optional Properties
themeId string The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.insert request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile. writable


If successful, this method returns a Drives resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.