Update renewal notifications

less than a minute

POST https://daas.digicert.com/apicontroller/v1/certificate/updateRenewalEmailPrefere

Use this endpoint to enable or disable renewal notifications for SSL/TLS certificates that are discovered to be expiring soon, regardless of issuing Certificate Authority (CA).

Example requests and responses

cURL

curl -X POST \
  https://daas.digicert.com/apicontroller/v1/certificate/updateRenewalEmailPrefere \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "accountId": 126993,
    "divisionIds": [69748, 69750, 97665, 253787, 96846, 70530, 100045, 98332, 126324, 69749, 303027, 94317, 124925, 553810, 531373, 376492],
    "certificateId": ["38acaea364581289a6fa38de3108841b19078e0d"],
    "renewalEmailPreference": true
}'

200 OK

{
    "error": null,
    "data": {
        "error": null,
        "data": "Renewal notices enabled."
    }
}

Request parameters

Name	Req/Opt	Type	Description
accountId	required	string	Account ID.
divisionIds	optional	array	User’s division IDs.
certificateId	required	array	Unique DigiCert-generated ID for the certificate found on the endpoint. Get the certificate ID from the List certificates request.
renewalEmailPreference	required	boolean	Whether renewal email preference should be enabled or disabled.