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.
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, 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 ( |
Certificate revoked
CertCentral sends certificate revoked (certificate_revoked
) events when a certificate in your CertCentral account is revoked.
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.
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.
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: |
.. validation_type | string | Validation type associated with the event. Possible values:
|
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.
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: |
.. validation_type | string | Validation type associated with the event. Possible values:
|
Domain validated
CertCentral sends domain validated (domain_validated
) events when domain control validation is completed for a domain in your CertCentral account.
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.
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. |