---
title: "List webhooks"
source_url: https://dev.digicert.com/certcentral-apis/services-api/webhooks/list-webhooks.html
api_method: GET
api_endpoint: "/services/v2/webhook"
api_url: "https://www.digicert.com/services/v2/webhook"
---

**GET** `https://www.digicert.com/services/v2/webhook`

Use this endpoint to get information about your CertCentral webhooks.


> **Info**
>
> Because a CertCentral account can only have one webhook, this endpoint returns a `webhooks` list with a single webhook object.


## Example requests and responses

## cURL

```bash
curl --request GET 'https://www.digicert.com/services/v2/webhook' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json'
```

## 200 OK

```json
{
  "webhooks": [
    {
      "id": 12345,
      "endpoint": "https://www.example.com/my/webhook",
      "events": [
        "organization_revalidation_notice",
        "domain_expired",
        "domain_revalidation_notice",
        "certificate_revoked",
        "order_rejected",
        "organization_expired",
        "organization_validated",
        "domain_validated",
        "certificate_issued"
      ],
      "status": "active",
      "webhook_settings": {
        "webhook_notification_frequency": [
          90,
          60,
          30,
          7,
          0,
          -7
        ],
        "instant_issue_webhook_notification": "1",
        "webhook_send_certificate_chain": "1",
        "webhook_send_instant_issued_certificate_chain": "1"
      }
    }
}
```

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>webhooks</td>
<td>array</td>
<td>List of objects with information about the webhooks in your CertCentral account.</td>
</tr>
<tr>
<td>.. id</td>
<td>number</td>
<td>Webhook ID.</td>
</tr>
<tr>
<td>.. endpoint</td>
<td>string</td>
<td>Endpoint URL where your webhook listener is hosted.</td>
</tr>
<tr>
<td>.. secret</td>
<td>string</td>
<td>Secret key value that DigiCert sends in the <code>X-WEBHOOK-KEY</code> request header with webhook events. For increased security, configure your webhook listener to validate the <code>X-WEBHOOK-KEY</code> value in each received event.<br>Omitted if no <code>secret</code> is configured for the webhook.</td>
</tr>
<tr>
<td>.. events</td>
<td>array of strings</td>
<td>List of events CertCentral sends to the endpoint for this webhook.<br><strong>Possible values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/webhooks/certcentral-event-types.md">CertCentral event types</a>.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Webhook status (<code>pending</code>, <code>active</code>, <code>inactive</code>).</td>
</tr>
<tr>
<td>webhook_settings</td>
<td>object</td>
<td>Optional settings for customizing certificate issued, validation expired, and revalidation notice events.</td>
</tr>
<tr>
<td>.. webhook_notification_frequency</td>
<td>array of integers</td>
<td>Array of values that determine when you receive notifications for <code>organization_expired</code>, <code>organization_revalidation_notice</code>, <code>domain_expired</code>, and <code>domain_revalidation_notice</code> events. The <code>webhook_notification_frequency</code> array includes one or more of the following numbers:<br><ul><li><code>90</code>: 90 days before event</li><li><code>60</code>: 60 days before event</li><li><code>30</code>: 30 days before event</li><li><code>7</code>: Seven days before event</li><li><code>0</code>: Day of event</li><li><code>-7</code>: Seven days after event</li></ul></td>
</tr>
<tr>
<td>.. instant_issue_webhook_notification</td>
<td>string</td>
<td>If <code>0</code>, CertCentral sends <code>certificate_issued</code> events only for certificates that are not issued the instant the order is created. If <code>1</code>, CertCentral sends <code>certificate_issued</code> events every time a certificate is issued, including certificates issued immediately.</td>
</tr>
<tr>
<td>.. webhook_send_certificate_chain</td>
<td>string</td>
<td>If <code>1</code>, <code>certificate_issued</code> events for public and private TLS/SSL certificates include the certificate chain for certificates that are not not issued the instant the order is created. Otherwise, <code>0</code> (default).<br>Learn more: [Customize certificate issued events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-certificate-issued-events.md)</td>
</tr>
<tr>
<td>.. webhook_send_instant_issued_certificate_chain</td>
<td>string</td>
<td>If <code>1</code>, <code>certificate_issued</code> events for public and private TLS/SSL certificates include the certificate chain for certificates issued the instant the order is created. Otherwise, <code>0</code> (default).<br>Learn more: [Customize certificate issued events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-certificate-issued-events.md)</td>
</tr>
</tbody>
</table>

## Error cases

<table>
<thead>
<tr>
<th>Status</th>
<th>Code</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>400</td>
<td>webhook_invalid_account</td>
<td>No webhook exists for the account.</td>
</tr>
</tbody>
</table>