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

This endpoint controls whether renewal notifications are enabled or disabled for the specified discovered certificates. To configure additional renewal notification recipients, see Update renewal notification recipients.

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.