Additional emails

2 minute read

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.

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

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

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"
	]
}'

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)

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))

}

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);
});

204 No Content

// empty

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.).

Was this page helpful?

Provide feedback