---
title: "Customize certificate issued events"
source_url: https://dev.digicert.com/certcentral-apis/webhooks/customize-certificate-issued-events.html
---

## Include certificate chain in certificate_issued events

By default, certificate issued events only include the ID of the issued certificate and the certificate order. However, for public and private TLS/SSL certificates, you can configure certificate issued events to include the complete certificate chain.


> **Info**
>
> CertCentral only sends the certificate chain in `certificate_issued` events for public and private TLS certificates. For other product types, `certificate_issued` events never include the certificate chain.


To receive the certificate chain in `certificate_issued` events for TLS certificates, update your webhook configuration as follows:


> **Info**
>
> `certificate_issued` events are sent only after a certificate is issued. If an order requires approval before issuance, CertCentral may send separate order approval lifecycle webhook events (for example, when approval emails are sent and when approval is completed). To track approval status, enable the relevant order approval events in your webhook configuration. <br>For more information, see [CertCentral event types](https://dev.digicert.com/md/certcentral-apis/webhooks/certcentral-event-types.md) for event types and event data.


### Use the Webhooks page in CertCentral

1. In your CertCentral account, in the sidebar menu, click **Settings** > **Webhooks**.
2. On the **Webhooks** page, make sure you have certificate issued events enabled. Then, check the box next to each option you want to enable:
   - **Receive the certificate chain when issued**
     When enabled, `certificate_issued` events include the certificate chain for certificates **not** issued the instant the order is created.
   - **Receive the certificate chain when issued instantly**
     When enabled, `certificate_issued` events include the certificate chain for certificates issued the instant the order is created.
   
> **Tip**
>
> Enable both options to receive the `certificate_chain` in all `certificate_issued` events for TLS certificates.


### Use the CertCentral Services API

If you are configuring a webhook using the CertCentral Services API, include one or both of these parameters in your API request to [create](https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/create-webhook.md) or [update](https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/update-webhook-endpoint.md) the webhook:

- `webhook_send_certificate_chain`
  If `true`, `certificate_issued` events for public and private TLS/SSL certificates include the certificate chain, but only if the certificate is not issued the instant the order is created. Otherwise, `false` (default).
- `webhook_send_instant_issued_certificate_chain`
  If `true`, `certificate_issued` events include the certificate chain, but only if the certificates is issued the instant the order is created.


> **Tip**
>
> Enable both options to receive the `certificate_chain` in all `certificate_issued` events for TLS certificates.


```
{
  ...
  "webhook_settings": {
    "webhook_send_certificate_chain": true,
    "webhook_send_instant_issued_certificate_chain": true
  }
}
```

## Receive notifications for certificates issued instantly

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.


> **Info**
>
> This setting only affects when CertCentral sends the `certificate_issued` event (including instantly issued certificates). It does not control order approval lifecycle events. If your workflow needs visibility into approval steps (for example, approval email sent or approval completed), enable the corresponding order approval events. <br>For more information, see [CertCentral event types](https://dev.digicert.com/md/certcentral-apis/webhooks/certcentral-event-types.md) for event types and event data.


### Use the Webhooks page in CertCentral

1. In your CertCentral account, in the sidebar menu, click **Settings** > **Webhooks**.
2. On the **Webhooks** page, make sure you have certificate issued events enabled. Then, check the box next to **Receive notifications for certificates issued instantly.**

### Use the CertCentral Services API

If you are configuring a webhook using the CertCentral Services API, include the `instant_issue_webhook_notification` webhook setting in your API request to [create](https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/create-webhook.md) or [update](https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/update-webhook-endpoint.md) the webhook:

```
{
  ...
  "webhook_settings": {
    "instant_issue_webhook_notification": "1"
  }
}
```