---
title: "Update renewal notifications"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/certificates/update-renewal-notifications.html
api_method: POST
api_endpoint: "/apicontroller/v1/certificate/updateRenewalEmailPrefere"
api_url: "https://daas.digicert.com/apicontroller/v1/certificate/updateRenewalEmailPrefere"
---

**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](https://dev.digicert.com/md/certcentral-apis/discovery-api/scan-lifecycle/create-scan.md) to be expiring soon, regardless of issuing Certificate Authority (CA).

## Example requests and responses

## cURL

```bash
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

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

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>divisionIds</td>
<td>optional</td>
<td>array</td>
<td>User's division IDs.</td>
</tr>
<tr>
<td>certificateId</td>
<td>required</td>
<td>array</td>
<td>Unique DigiCert-generated ID for the certificate found on the endpoint. Get the certificate ID from the <a href="https://dev.digicert.com/md/certcentral-apis/discovery-api/certificates/list-certificates.md">List certificates</a> request.</td>
</tr>
<tr>
<td>renewalEmailPreference</td>
<td>required</td>
<td>boolean</td>
<td>Whether renewal email preference should be enabled or disabled.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Includes the error code, if any.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object container for response.</td>
</tr>
<tr>
<td>.. data</td>
<td>string</td>
<td>Message with information about the request.</td>
</tr>
</tbody>
</table>