CertCentral event types

Certificate issued

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

Note

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.

Example 1. certificate_issued event data

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

Example 2. certificate_issued event data with certificate_chain

{
  "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 1. Certificate issued event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. order_id	integer	ID of the order associated with the event.
.. certificate_id	integer	ID of the certificate associated with the event.
.. certificate_chain	array of objects	For public and private TLS/SSL certificates, you can configure certificate issued events to include the complete certificate chain. If you do, `certificate_issued` events return a `certificate_chain` array. Each object in the array has the `subject_common_name` and `pem` data for a certificate in the chain (end-entity certificate and issuing intermediate and root CA certificates). Learn more: Customize certificate issued events
.. .. subject_common_name	string	Subject common name of a certificate in the certificate chain.
.. .. pem	string	PEM data for a certificate in the certificate chain. Includes escaped carriage return and newline characters at each line break (`\r\n`).

Certificate revoked

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

Table 2. Certificate revoked event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. order_id	integer	ID of the order associated with the event.
.. certificate_id	integer	ID of the certificate associated with the event.

Order rejected

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

Table 3. Order rejected event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. order_id	integer	ID of the order associated with the event.
.. certificate_id	integer	ID of the certificate associated with the event.

Organization validated

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

Table 4. Organization validated event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. organization_id	integer	ID of the organization associated with the event.
.. validated_until	string	Date validation expires for the given organization. Format: `YYYY-MM-DD`
.. validation_type	string	Validation type associated with the event. Possible values: `OV` `EV` `CS` `EV_CS` `DS`

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.

Note

You can customize the timing of revalidation notice and validation expired events for domains and organizations. See Customize validation expired and revalidation notice events.

Table 5. Organization expired/organization revalidation notice event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. organization_id	integer	ID of the organization associated with the event.
.. validated_until	string	Date validation expires for the given organization. Format: `YYYY-MM-DD`
.. validation_type	string	Validation type associated with the event. Possible values: `OV` `EV` `CS` `EV_CS` `DS`

Domain validated

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

Table 6. Domain validated event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. domain_id	integer	ID of the domain associated with the event.
.. validated_until	string	Date and time validation expires for the given domain or organization. ISO 8601 format.

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.

Note

You can customize the timing of revalidation notice and validation expired events for domains and organizations. See Customize validation expired and revalidation notice events.

Table 7. Domain expiration/domain revalidation notice event data

Name	Type	Description
event	string	Event type.
data	object	Object with event data.
.. domain_id	integer	ID of the domain associated with the event.
.. validated_until	string	Date and time validation expires for the given domain or organization. ISO 8601 format.

CertCentral event types

Certificate issued

Note

Certificate revoked

Order rejected

Organization validated

Organization expired/organization revalidation notice

Note

Domain validated

Domain expired/domain revalidation notice

Note

Search results