---
title: "Create a New Block Storage Volume"
method: POST
path: "/v2/volumes"
tags: ["DigitalOcean-public.v2-new_Block Storage"]
---

# Create a New Block Storage Volume

`POST /v2/volumes`

To create a new volume, send a POST request to `/v2/volumes`. Optionally, a `filesystem_type` attribute may be provided in order to automatically format the volume's filesystem. Pre-formatted volumes are automatically mounted when attached to Ubuntu, Debian, Fedora, Fedora Atomic, and CentOS Droplets created on or after April 26, 2018. Attaching pre-formatted volumes to Droplets without support for auto-mounting is not recommended.

## Request body

- union
  - VolumesExt4
    - `id` string — The unique identifier for the block storage volume.
    - `droplet_ids` integer[], nullable — An array containing the IDs of the Droplets the volume is attached to. Note that at this time, a volume can only be attached to a single Droplet.
    - `name` string, required — A human-readable name for the block storage volume. Must be lowercase and be composed only of numbers, letters and "-", up to a limit of 64 characters. The name must begin with a letter.
    - `description` string — An optional free-form text field to describe a block storage volume.
    - `size_gigabytes` integer, required — The size of the block storage volume in GiB (1024^3). This field does not apply when creating a volume from a snapshot.
    - `created_at` string — A time value given in ISO8601 combined date and time format that represents when the block storage volume was created.
    - `tags` string[], nullable — A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags. <br><br>Requires `tag:create` scope.
    - `snapshot_id` string — The unique identifier for the volume snapshot from which to create the volume.
    - `filesystem_type` string — The name of the filesystem type to be used on the volume. When provided, the volume will automatically be formatted to the specified filesystem type. Currently, the available options are `ext4` and `xfs`. Pre-formatted volumes are automatically mounted when attached to Ubuntu, Debian, Fedora, Fedora Atomic, and CentOS Droplets created on or after April 26, 2018. Attaching pre-formatted volumes to other Droplets is not recommended.
    - `region` 'ams1' | 'ams2' | 'ams3' | 'blr1' | 'fra1' | 'lon1' | 'nyc1' | 'nyc2' | 'nyc3' | 'sfo1' | 'sfo2' | 'sfo3' | 'sgp1' | 'tor1' | 'syd1', required — The slug identifier for the region where the resource will initially be available.
    - `filesystem_label` string — The label applied to the filesystem. Labels for ext4 type filesystems may contain 16 characters while labels for xfs type filesystems are limited to 12 characters. May only be used in conjunction with filesystem_type.
  - VolumesXfs
    - `id` string — The unique identifier for the block storage volume.
    - `droplet_ids` integer[], nullable — An array containing the IDs of the Droplets the volume is attached to. Note that at this time, a volume can only be attached to a single Droplet.
    - `name` string, required — A human-readable name for the block storage volume. Must be lowercase and be composed only of numbers, letters and "-", up to a limit of 64 characters. The name must begin with a letter.
    - `description` string — An optional free-form text field to describe a block storage volume.
    - `size_gigabytes` integer, required — The size of the block storage volume in GiB (1024^3). This field does not apply when creating a volume from a snapshot.
    - `created_at` string — A time value given in ISO8601 combined date and time format that represents when the block storage volume was created.
    - `tags` string[], nullable — A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags. <br><br>Requires `tag:create` scope.
    - `snapshot_id` string — The unique identifier for the volume snapshot from which to create the volume.
    - `filesystem_type` string — The name of the filesystem type to be used on the volume. When provided, the volume will automatically be formatted to the specified filesystem type. Currently, the available options are `ext4` and `xfs`. Pre-formatted volumes are automatically mounted when attached to Ubuntu, Debian, Fedora, Fedora Atomic, and CentOS Droplets created on or after April 26, 2018. Attaching pre-formatted volumes to other Droplets is not recommended.
    - `region` 'ams1' | 'ams2' | 'ams3' | 'blr1' | 'fra1' | 'lon1' | 'nyc1' | 'nyc2' | 'nyc3' | 'sfo1' | 'sfo2' | 'sfo3' | 'sgp1' | 'tor1' | 'syd1', required — The slug identifier for the region where the resource will initially be available.
    - `filesystem_label` string — The label applied to the filesystem. Labels for ext4 type filesystems may contain 16 characters while labels for xfs type filesystems are limited to 12 characters. May only be used in conjunction with filesystem_type.

## Response `201`

The response will be a JSON object with a key called `volume`. The value will be an object containing the standard attributes associated with a volume.

- object
  - `volume` VolumeFull
    - `id` string — The unique identifier for the block storage volume.
    - `droplet_ids` integer[], nullable — An array containing the IDs of the Droplets the volume is attached to. Note that at this time, a volume can only be attached to a single Droplet.
    - `name` string — A human-readable name for the block storage volume. Must be lowercase and be composed only of numbers, letters and "-", up to a limit of 64 characters. The name must begin with a letter.
    - `description` string — An optional free-form text field to describe a block storage volume.
    - `size_gigabytes` integer — The size of the block storage volume in GiB (1024^3). This field does not apply when creating a volume from a snapshot.
    - `created_at` string — A time value given in ISO8601 combined date and time format that represents when the block storage volume was created.
    - `tags` string[], nullable — A flat array of tag names as strings applied to the resource. <br><br>Requires `tag:read` scope.
    - `region` object — The region that the block storage volume is located in. When setting a region, the value should be the slug identifier for the region. When you query a block storage volume, the entire region object will be returned.
      - `name` string, required — The display name of the region. This will be a full name that is used in the control panel and other interfaces.
      - `slug` string, required — A human-readable string that is used as a unique identifier for each region.
      - `features` string[], required — This attribute is set to an array which contains features available in this region
      - `available` boolean, required — This is a boolean value that represents whether new Droplets can be created in this region.
      - `sizes` string[], required — This attribute is set to an array which contains the identifying slugs for the sizes available in this region. sizes:read is required to view.
    - `filesystem_type` string — The type of filesystem currently in-use on the volume.
    - `filesystem_label` string — The label currently applied to the filesystem.

## Other responses

- `400` — There was an error parsing the request body.
- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)