Skip to main content

Webhook logs

Webhook logs are a type of log that record information about webhooks sent from FastAuth to your system.

Webhook logs can be useful for several purposes, including:

  • Debugging: Webhook logs can help you troubleshoot issues with your webhook implementation by providing a detailed record of all webhook requests and responses.
  • Monitoring: Webhook logs can help you monitor the performance and reliability of your webhook integration by tracking errors.
  • Auditing: Webhook logs can help you maintain a record of all webhook activity, which may be useful for compliance and auditing purposes.

In FastAuth, webhook logs provide the ability to trigger a certain webhook with the data that was sent originally. This can be useful for testing and debugging webhook integrations, or for re-triggering failed or missed webhook requests.

List all logs for selected webhook:​

This endpoint returns a list of all logs for the specified webhook. To get a full list of log properties you need to use get log details

Get log details​

This endpoint returns a list of all log properties for the specified webhook.

Webhook Log Response DTO​

Fields of WebhookLogResponseDto class:

FieldTypeDescription
IdGuidA unique identifier for the webhook log entry.
EnrollmentIdGuidThe ID of the enrollment associated with the webhook.
SentDateDateTimeThe date and time when the webhook was sent.
StatusWebhookStatusTypeThe status of the webhook, as an enum of type WebhookStatusType.
TopicstringThe topic of the webhook, indicating the event or data that triggered it.
UrlstringThe URL of the endpoint that the webhook was sent to.
ErrorMessagestringAny error message associated with the webhook, if applicable.
WebhookDataJObjectA JSON object containing the data sent with the webhook.
ResponsestringThe response received from the endpoint that the webhook was sent to.
ResponseStatusCodeHttpStatusCode?The HTTP status code received from the endpoint that the webhook was sent to.
RelatedEntityIdGuidThe ID of a related entity.
RelatedEntityTypestringThe type of the related entity.

Re-trigger the webhook​

The following endpoint can rerun the webhook.

All requests sent using this endpoint will have the same enrollmentId.

Data retention​

Webhook logs are stored for 90 days.