Sign in

v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_VPCs

Create a New VPC

To create a VPC, send a POST request to /v2/vpcs specifying the attributes in the table below in the JSON body.

Note: If you do not currently have a VPC network in a specific datacenter region, the first one that you create will be set as the default for that region. The default VPC for a region cannot be changed or deleted.

post/v2/vpcs

Request body

namestring required

The name of the VPC. Must be unique and may only contain alphanumeric characters, dashes, and periods.

descriptionstring

A free-form text field for describing the VPC's purpose. It may be a maximum of 255 characters.

regionstring required

The slug identifier for the region where the VPC will be created.

ip_rangestring

The range of IP addresses in the VPC in CIDR notation. Network ranges cannot overlap with other networks in the same account and must be in range of private addresses as defined in RFC1918. It may not be smaller than /28 nor larger than /16. If no IP range is specified, a /20 network range is generated that won't conflict with other VPC networks in your account.

Example request

{
  "name": "env.prod-vpc",
  "description": "VPC for production environment",
  "region": "nyc1",
  "ip_range": "10.10.10.0/24"
}

Response

The response will be a JSON object with a key called vpc. The value of this will be an object that contains the standard attributes associated with a VPC.

Example response

{
  "vpc": {
    "name": "env.prod-vpc",
    "description": "VPC for production environment",
    "region": "nyc1",
    "ip_range": "10.10.10.0/24",
    "default": true,
    "id": "5a4981aa-9653-4bd1-bef5-d6bff52042e4",
    "urn": "do:droplet:13457723",
    "created_at": "2020-03-13T19:20:47.442049222Z"
  }
}