---
title: "CertCentral event types"
source_url: https://dev.digicert.com/certcentral-apis/webhooks/certcentral-event-types.html
---

## Certificate issued

CertCentral sends certificate issued (`certificate_issued`) events when DigiCert issues a certificate in your CertCentral account.


> **Info**
>
> By default, CertCentral only sends certificate issued events for certificates that are not issued the instant the order is created. To receive certificate issued events every time a certificate is issued, enable notifications for certificates issued instantly. Learn more: [Customize certificate issued events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-certificate-issued-events.md).


**certificate_issued event data**

```json
{
  "event": "certificate_issued",
  "data": {
    "order_id": 12345,
    "certificate_id": 23456
  }
}
```

**certificate_issued event data with certificate_chain**

```json
{
  "event": "certificate_issued",
  "data": {
    "order_id": 1234,
    "certificate_id": 1234,
    "certificate_chain": [
      {
        "subject_common_name": "example.com",
        "pem": "-----BEGIN CERTIFICATE-----\r\nMII...\r\n-----END CERTIFICATE-----\r\n"
      },
      {
        "subject_common_name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1",
        "pem": "-----BEGIN CERTIFICATE-----\r\nMII...\r\n-----END CERTIFICATE-----\r\n"
      },
      {
        "subject_common_name": "DigiCert Global Root G2",
        "pem": "-----BEGIN CERTIFICATE-----\r\nMII...\r\n-----END CERTIFICATE-----\r\n"
      }
    ]
  }
}
```


<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>ID of the order associated with the event.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>ID of the certificate associated with the event.</td>
</tr>
<tr>
<td>.. certificate_chain</td>
<td>array of objects</td>
<td>For public and private TLS/SSL certificates, you can configure certificate issued events to include the complete certificate chain. If you do, <code>certificate_issued</code> events return a <code>certificate_chain</code> array. Each object in the array has the <code>subject_common_name</code> and <code>pem</code> data for a certificate in the chain (end-entity certificate and issuing intermediate and root CA certificates).<br>Learn more: [Customize certificate issued events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-certificate-issued-events.md)</td>
</tr>
<tr>
<td>.. .. subject_common_name</td>
<td>string</td>
<td>Subject common name of a certificate in the certificate chain.</td>
</tr>
<tr>
<td>.. .. pem</td>
<td>string</td>
<td>PEM data for a certificate in the certificate chain. Includes escaped carriage return and newline characters at each line break (<code>\r\n</code>).</td>
</tr>
</tbody>
</table>

## Certificate revoked

CertCentral sends certificate revoked (`certificate_revoked`) events when a certificate in your CertCentral account is revoked.

### certificate_revoked event data

```json
{
  "event": "certificate_revoked",
  "data": {
    "order_id": 12345,
    "certificate_id": 23456
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>ID of the order associated with the event.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>ID of the certificate associated with the event.</td>
</tr>
</tbody>
</table>

## Order rejected

CertCentral sends order rejected (`order_rejected`) events when an order in your CertCentral account is rejected.

### order_rejected event data

```json
{
  "event": "order_rejected",
  "data": {
    "order_id": 12345,
    "certificate_id": 23456
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>ID of the order associated with the event.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>ID of the certificate associated with the event.</td>
</tr>
</tbody>
</table>


## Order approval email sent

This event is triggered when an order approval email is sent to one or more verified approvers for a certificate order that requires approval.

### order_approval_email_sent event data

```json

{
  "event": "order_approval_email_sent",
  "data": {
    "order_id": 470091052,
    "certificate_id": 471270113,
    "orderApprovalEmailStatus": "sent",
    "orderApprovalEmails": [
      "approver1@example.com",
      "approver2@example.com"
    ]
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>ID of the order associated with the event.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>ID of the certificate associated with the event.</td>
</tr>

<td>.. orderApprovalEmailStatus</td>
<td>string</td>
<td>Indicates the current status of the order approval email.<br>Always <code>sent</code> for this event.</td>
</tr>

<td>.. orderApprovalEmails</td>
<td>array[string]</td>
<td>List of email addresses the approval email is sent to. Includes only validated contact emails provided in the order.</td>
</tr>
</tbody>
</table>


## Order approval complete

This event is triggered when an an approver completes the order approval.

### order_approval_complete event data

```json
{
  "event": "order_approval_complete",
  "data": {
    "order_id": 470091052,
    "certificate_id": 471270113,
    "orderApprovalEmailStatus": "complete"
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>ID of the order associated with the event.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>ID of the certificate associated with the event.</td>
</tr>
<td>.. orderApprovalEmailStatus</td>
<td>string</td>
<td>Indicates the current status of the order approval email.<br>Always <code>complete</code> for this event.</td>
</tr>
</tbody>
</table>


## Organization validated

CertCentral sends organization validated (`organization_validated`) events when the validation process is completed for an organization in your CertCentral account.

### organization_validated

```json
{
  "event": "organization_validated",
  "data": {
    "organization_id": 12345,
    "validated_until": "2024-08-10",
    "validation_type": "OV"
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. organization_id</td>
<td>integer</td>
<td>ID of the organization associated with the event.</td>
</tr>
<tr>
<td>.. validated_until</td>
<td>string</td>
<td>Date validation expires for the given organization. Format: <code>YYYY-MM-DD</code></td>
</tr>
<tr>
<td>.. validation_type</td>
<td>string</td>
<td>Validation type associated with the event.<br><strong>Possible values:</strong><br><ul><li><code>OV</code></li><li><code>EV</code></li><li><code>CS</code></li><li><code>EV_CS</code></li><li><code>DS</code></li></ul></td>
</tr>
</tbody>
</table>

## Organization expired/organization revalidation notice

There are two CertCentral webhook events that notify you when validation (OV, EV, code signing, or EV code signing) for an organization is about to expire:

- Organization expired (`organization_expired`)
- Organization revalidation notice (`organization_revalidation_notice`)

Both `organization_expired` and `organization_revalidation_notice` events are triggered relative to the expiration date of the given validation type. The only difference in behavior between these two events is the name CertCentral sends in the `event` field.


> **Info**
>
> You can customize the timing of revalidation notice and validation expired events for domains and organizations. See [Customize validation expired and revalidation notice events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-validation-expired-and-revalidation-notice-events.md).


**organization_expired**

```json
{
  "event": "organization_expired",
  "data": {
    "organization_id": 12345,
    "validated_until": "2024-08-10",
    "validation_type": "OV"
  }
}
```

**organization_revalidation_notice**

```json
{
  "event": "organization_revalidation_notice",
  "data": {
    "organization_id": 12345,
    "validated_until": "2024-08-10",
    "validation_type": "OV"
  }
}
```


<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. organization_id</td>
<td>integer</td>
<td>ID of the organization associated with the event.</td>
</tr>
<tr>
<td>.. validated_until</td>
<td>string</td>
<td>Date validation expires for the given organization. Format: <code>YYYY-MM-DD</code></td>
</tr>
<tr>
<td>.. validation_type</td>
<td>string</td>
<td>Validation type associated with the event.<br><strong>Possible values:</strong><br><ul><li><code>OV</code></li><li><code>EV</code></li><li><code>CS</code></li><li><code>EV_CS</code></li><li><code>DS</code></li></ul></td>
</tr>
</tbody>
</table>

## Domain validated

CertCentral sends domain validated (`domain_validated`) events when domain control validation is completed for a domain in your CertCentral account.

### domain_validated

```json
{
  "event": "domain_validated",
  "data": {
    "domain_id": 12345,
    "validated_until": "2024-08-10T12:45:02-06:00"
  }
}
```

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. domain_id</td>
<td>integer</td>
<td>ID of the domain associated with the event.</td>
</tr>
<tr>
<td>.. validated_until</td>
<td>string</td>
<td>Date and time validation expires for the given domain or organization. ISO 8601 format.</td>
</tr>
</tbody>
</table>

## Domain expired/domain revalidation notice

There are two CertCentral webhook events that notify you when domain control validation (DCV) for a domain is about to expire:

- Domain expired (`domain_expired`)
- Domain revalidation notice (`domain_revalidation_notice`)

Both `domain_expired` and `domain_revalidation_notice` events are triggered relative to the expiration date of the given domain's validation. The only difference in behavior between these two events is the name CertCentral sends in the `event` field.


> **Info**
>
> You can customize the timing of revalidation notice and validation expired events for domains and organizations. See [Customize validation expired and revalidation notice events](https://dev.digicert.com/md/certcentral-apis/webhooks/customize-validation-expired-and-revalidation-notice-events.md).


**domain_expired**

```json
{
  "event": "domain_expired",
  "data": {
    "domain_id": 12345,
    "validated_until": "2024-08-10T12:45:02-06:00"
  }
}
```

**domain_revalidation_notice**

```json
{
  "event": "domain_revalidation_notice",
  "data": {
    "domain_id": 12345,
    "validated_until": "2024-08-10T12:45:02-06:00"
  }
}
```


<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>event</td>
<td>string</td>
<td>Event type.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with event data.</td>
</tr>
<tr>
<td>.. domain_id</td>
<td>integer</td>
<td>ID of the domain associated with the event.</td>
</tr>
<tr>
<td>.. validated_until</td>
<td>string</td>
<td>Date and time validation expires for the given domain or organization. ISO 8601 format.</td>
</tr>
</tbody>
</table>