CertCentral event types

Certificate issued

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

• certificate_issued event data
• certificate_issued event data with certificate_chain

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

{
  "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"
      }
    ]
  }
}

Certificate revoked

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

certificate_revoked event data

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

Order rejected

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

order_rejected event data

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

Organization validated

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

organization_validated

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

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.

• organization_expired
• organization_revalidation_notice

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

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

Domain validated

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

domain_validated

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

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.

• domain_expired
• domain_revalidation_notice

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

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