Resend DCV email

2 minute read

PUT https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails

Use this endpoint to resend domain control validation (DCV) emails for a domain.

Example requests and responses

curl -X PUT \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "name_scope": "sub.example.com"
}'

import requests

url = "https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails"

payload = "{\n  \"name_scope\": \"sub.example.com\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("PUT", url, data=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails"

	payload := strings.NewReader("{\n  \"name_scope\": \"sub.example.com\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

var request = require("request");

var options = { method: 'PUT',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { name_scope: 'sub.example.com' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

204 No Content

// empty

Request parameters

Name	Req/Opt	Type	Description
name_scope	optional	string	The FQDN associated with the domain ID.
locale	optional	string	Locale code for the language of the email. Allowed values: See Glossary – Locale codes.
email_array	optional	array of strings	Limit who receives verification DCV emails to addresses in this list. Each email address must be a valid constructed email address for the domain or an approved DNS-based email contact from the domain’s DNS TXT record. Other email addresses are ignored. Your CertCentral account settings configure the addresses you can choose from when limiting verification DCV email recipients. If none of the emails you provide are configured to receive verification DCV emails, or if you omit the `email_array` parameter from your request, DigiCert sends emails to all constructed email addresses and DNS TXT record emails for the domain. To view your account settings, in the left main menu, go to Settings > Preferences. Then, on the Preferences page, expand Advanced Settings, and look under Send Verification DCV Emails to.