Email site seal

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

Use this endpoint to request an email with the site seal code for an order. DigiCert emails the code to the user associated with the API key in the header.

Changing site seal settings

You can change the size or brand of the site seal when you request the site seal code. Changing these settings updates the appearance of the site seal on any website that uses the code.*

  • To get the current size and brand for a seal, use the Site seal settings endpoint (see seal_size and seal_number).
  • To request the seal code without changing any settings, omit the JSON payload from your Email site seal request.

*Note

On March 25, 2021, DigiCert improved how CertCentral stores your site seal settings. Now, you can update the size and brand of your site seal without replacing the site seal code on your website. This change affects all site seal codes you receive and implement after March 25, 2021.

For codes you received and implemented before March 25, 2021:

If you don’t change the size or brand for the site seal:

  • No action is required.
  • Your existing site seal code will continue to work as expected.

If you update the size or brand for the site seal via CertCentral or the Services API:

  • You must replace the site seal code on your website for those changes to appear.
  • After you replace the seal code on your website, you can update the size and brand of the seal by changing those settings within CertCentral or by using the Email site seal endpoint.
  • Changes may take up to two hours to appear on websites that use the new seal code.

Example requests and responses

cURL
curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
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)
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))
}
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);
});
204 No Content
// empty

Path parameters

Name Type Description
order_id string ID of the order associated with the seal.

Request parameters

Name Req/Opt Type Description
seal_hash optional string Hash of the site seal associated with the order.
seal_number optional int Number that identifies the type of seal to display.
Allowed values:
  • 15 (Norton)
  • 16 (GeoTrust)
  • 17 (Thawte)
  • 18 (DigiCert)
seal_size optional string Site seal size.
Allowed values:
  • s (small)
  • m (medium)
  • l (large)
seal_color
Deprecated*
optional string Color of the site seal text.

*DigiCert has deprecated the seal_color parameter. We ignore this parameter in calls to the Email site seal endpoint.
seal_language
Deprecated*
optional string Language of the site seal pop-up.

*DigiCert has deprecated the seal_language parameter. We ignore this parameter in calls to the Email site seal endpoint.