Skip to main content

Email site seal

POST https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal

Use this endpoint to send an email with the site seal code for an order. By default, DigiCert emails the site seal code to the authenticated user (the user that owns the API key in the request header). To choose a different recipient, use the optional recipient_email request parameter.

Tip

Updating your site seal

To change the settings for a site seal, use the Update site seal settings endpoint.

Alternately, you can change the settings for a site seal with the same API request you use to email the site seal. The Email site seal endpoint honors the same request parameters as the Update site seal settings endpoint. See Update site seal settings for descriptions of these parameters and usage information.

Related topics

Example requests and responses

Example 1. cURL
curl 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "recipient_email": "john.doe@example.com"
}'

Example 2. Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal"

payload={}
headers = {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': "application/json"
    }

response = requests.request("POST", 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}}/site-seal/email-seal"
		method := "POST"

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, nil)

		if err != nil {
				fmt.Println(err)
				return
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := ioutil.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}

Example 4. NodeJS
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path parameters

Name

Type

Description

order_id

string

ID of the order associated with the seal.

Request parameters

Name

Req/Opt

Type

Description

recipient_email

optional

string

Email address of the site seal recipient. Must be a string containing a single email address. If omitted, DigiCert sends the site seal code to the authenticated user (the user that owns the API key in the request header).

If a recipient_email is present in your request body, the endpoint is throttled. If you exceed the throttle limit, CertCentral returns an HTTP response status code of 429 Too Many Requests .

In this section: