SSharaFormsDocs
Integrations

List Webhook Events

Retrieve a paginated list of webhook dispatch events for a specific integration.

GET/open/forms/{form}/integrations/{integrationid}/events

Retrieve a paginated list of webhook dispatch events for a specific integration.

#Authentication & Scope

This endpoint requires a Personal Access Token with the manage-integrations ability.

#Request

formnumber required

The ID of the form containing the webhook.

integrationidnumber required

The ID of the webhook integration for which to list events.

http
GET /open/forms/{form}/integrations/{integrationid}/events HTTP/1.1
Host: api.sharaforms.com
Authorization: Bearer <token>

#Response

200 OK – Returns an array of event objects, ordered by creation date (newest first).

#Event object properties

idnumber

Unique identifier for the event record.

integration_idnumber

The ID of the webhook integration that generated this event.

eventstring

The type of event. Currently: "submission.created".

statusstring

Result of the webhook dispatch. Values: "success", "failed", "timeout".

response_codenumber | null

HTTP status code returned by your webhook endpoint (if applicable).

error_messagestring | null

Error details if the webhook dispatch failed.

created_atstring

ISO 8601 timestamp of when the webhook was dispatched.

#Error responses

403 Forbidden – The token does not have manage-integrations ability or insufficient form permissions.

404 Not Found – Form or integration not found.

#Use cases

  • Debugging: Check recent events to verify your webhook is receiving requests.
  • Monitoring: Track success/failure rates to identify reliability issues.
  • Audit trail: Review when submissions were sent to your endpoint.