Skip to main content

Customize certificate issued events

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.

Note

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:

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 or update 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.

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 or update the webhook:

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