Skip to main content

Webhooks

CertCentral webhooks send automatic notifications to an external application when certificate events occur in your account. Use webhooks to receive real-time updates without querying the CertCentral Services API at regular intervals.

To receive webhook events, you must host a webhook listener at an endpoint URL you control. Your endpoint must be public-facing and respond to POST requests with standard successful HTTP response status codes (2XX).

For additional security, configure your webhook listener allowlist to accept incoming requests only from DigiCert IP addresses in the range 216.168.240.0/20

Create a webhook

  1. In the CertCentral main menu, go to Settings > Webhooks.

  2. On the Webhooks page, enter your endpoint in the Enter your endpoint URL field. Include the https:// prefix.

  3. To add a secret key for enhanced security, under Do you have a secret key, select Yes and enter a key value of at least 32 characters.

  4. Under Receive updates on, select the checkbox next to each event type you want to receive.

  5. Select Send test notification to verify CertCentral can connect to your endpoint.

    Your endpoint must respond with HTTP status code 200 OK.

  6. Within 30 minutes of receiving the verification token, enter it on the Webhooks page and select Activate webhook.

Your webhook is now active. CertCentral sends events to your endpoint immediately when triggered.

Deactivate a webhook

  1. In the CertCentral main menu, go to Settings > Webhooks.

  2. On the Webhooks page, select Deactivate push notification.

To resume, select Activate push notification.

Update a webhook endpoint

  1. In the CertCentral main menu, go to Settings > Webhooks.

  2. Select Update URL.

  3. Follow steps 2–5 from Create a webhook to enter, test, and verify the new endpoint.

Get webhook notifications in Slack

When you integrate CertCentral webhooks with Slack, your webhook sends notifications to a channel in your Slack workspace. CertCentral automatically recognizes Slack webhook URLs and formats event data for Slack.

To set up Slack notifications, obtain a Slack webhook URL from your Slack workspace, then use it as the endpoint URL when creating your webhook.

In this section: