Creates a new Drive folder. To update the metadata of an existing Drive file, including a folder, use drive_update().

drive_mkdir(name, parent = NULL, ..., verbose = TRUE)



Name for the new folder or, optionally, a path that specifies an existing parent folder, as well as the new name.


Target destination for the new folder, i.e. a folder or a Team Drive. Can be given as an actual path (character), a file id or URL marked with as_id(), or a dribble. Defaults to your "My Drive" root folder.


Named parameters to pass along to the Drive API. You can affect the metadata of the target file by specifying properties of the Files resource via .... See the "Request body" section of the Drive API docs for the associated endpoint.


Logical, indicating whether to print informative messages (default TRUE).


An object of class dribble, a tibble with one row per item.

See also

Wraps the files.create endpoint:


## Create folder named 'ghi', then another below named it 'jkl' and star it
ghi <- drive_mkdir("ghi")
jkl <- drive_mkdir("ghi/jkl", starred = TRUE)

## is 'jkl' really starred? YES
purrr::pluck(jkl, "drive_resource", 1, "starred")

## Another way to create folder 'mno' in folder 'ghi'
drive_mkdir("mno", parent = "ghi")

## Yet another way to create a folder named 'pqr' in folder 'ghi',
## this time with parent folder stored in a dribble,
## and setting the new folder's description
pqr <- drive_mkdir("pqr", parent = ghi, description = "I am a folder")

## Did we really set the description? YES
purrr::pluck(pqr, "drive_resource", 1, "description")

## clean up
# }