How to Add Domains

To add a domain via the command-line, follow these steps:

1. Install doctl, the DigitalOcean command-line tool.

2. Create a personal access token, and save it for use with doctl.

3. Use the token to grant doctl access to your DigitalOcean account.

                 doctl auth init
               

4. Finally, add a domain with doctl compute domain create. The basic usage looks like this, but you'll want to read the usage docs for more details:

                 doctl compute domain create <domain> [flags]
               

   The following command creates a domain named example.com and adds an A record to the domain

                  doctl compute domain create example.com --ip-address 198.51.100.215
               

To add a domain using the DigitalOcean API, follow these steps:

1. Create a personal access token, and save it for use with the API.

2. Send a POST request to https://api.digitalocean.com/v2/domains

   cURL

   To add a domain with cURL, call:

   
                   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
     -d '{"name":"example.com","ip_address":"1.2.3.4"}' \
     "https://api.digitalocean.com/v2/domains"

   Go

   Go developers can use Godo, the official DigitalOcean V2 API client for Go. To add a domain with Godo, use the following code:

   
                   import (
     "context"
     "os"
   
     "github.com/digitalocean/godo"
     )
   
   func main() {
     token := os.Getenv("DIGITALOCEAN_TOKEN")
   
     client := godo.NewFromToken(token)
     ctx := context.TODO()
   
     createRequest := &godo.DomainCreateRequest{
       Name:      "example.com",
       IPAddress: "1.2.3.4",
     }
   
     domain, _, err := client.Domains.Create(ctx, createRequest)
   
   }

   Ruby

   Ruby developers can use DropletKit, the official DigitalOcean V2 API client for Ruby. To add a domain with DropletKit, use the following code:

   
                   require 'droplet_kit'
   token = ENV['DIGITALOCEAN_TOKEN']
   client = DropletKit::Client.new(access_token: token)
   
   domain = DropletKit::Domain.new(
     name: 'example.com',
     ip_address: '1.2.3.4'
   )
   client.domains.create(domain)

   Python

   
                   import os
   from pydo import Client
   
   client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
   
   req = {
     "name": "example.com"
   }
   
   resp = client.domains.create(body=req)