Additional emails

PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/additional-emails

Use this endpoint to update the additional emails associated with an order.

Notice

Email addresses added to the additional_emails array receive email notifications for renewals, reissues, and duplicates for the specified order.

Important

This endpoint is destructive to the additional_emails array. The existing array will be overwritten with the new array that is sent. You can remove all additional email addresses from an order by passing an empty array.

Example requests and responses

Example 1. cURL

curl -X PUT \
  'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/additional-emails' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
	"additional_emails": [
		"jill.valentine@example.com",
		"leon.kennedy@example.com"
	]
}'

Example 2. Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/additional-emails"

payload = "{\n\t\"additional_emails\": [\n\t\t\"jill.valentine@example.com\",\n\t\t\"leon.kennedy@example.com\"\n\t]\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)

Example 3. Go

package main

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

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/additional-emails"

	payload := strings.NewReader("{\n\t\"additional_emails\": [\n\t\t\"jill.valentine@example.com\",\n\t\t\"leon.kennedy@example.com\"\n\t]\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))

}

Example 4. NodeJS

var request = require("request");

var options = { method: 'PUT',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/additional-emails',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { additional_emails: [ 'jill.valentine@example.com', 'leon.kennedy@example.com' ] },
  json: true };

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

  console.log(body);
});

Request parameters

Name	Req/Opt	Type	Description
additional_emails	required	array	Additional email addresses to receive certificate notification emails (e.g., certificate issuance, duplicate certificate, certificate renewals, etc.).

In this section: