curl 'https://api.opnform.com/open/forms/123/integrations/42/events' \
-H 'Authorization: Bearer YOUR_PAT'
[
{
"id": 1000,
"date": "2026-10-03 14:00",
"status": "Error",
"tracking_id": null,
"email_tracking": false,
"legacy_email": false,
"updated_at": "2026-10-03T14:00:00Z",
"data": { "submission_id": 1234, "message": "Connection failed" },
"can_retry": true,
"retry_unavailable_reason": null
}
]
Integrations
List Integration Events
Review delivery attempts and retry eligibility for a form integration.
GET
/
open
/
forms
/
{form}
/
integrations
/
{integrationid}
/
events
curl 'https://api.opnform.com/open/forms/123/integrations/42/events' \
-H 'Authorization: Bearer YOUR_PAT'
[
{
"id": 1000,
"date": "2026-10-03 14:00",
"status": "Error",
"tracking_id": null,
"email_tracking": false,
"legacy_email": false,
"updated_at": "2026-10-03T14:00:00Z",
"data": { "submission_id": 1234, "message": "Connection failed" },
"can_retry": true,
"retry_unavailable_reason": null
}
]
Authentication & Scope
Use a Personal Access Token withmanage-integrations and write access to the form’s workspace.
Request
curl 'https://api.opnform.com/open/forms/123/integrations/42/events' \
-H 'Authorization: Bearer YOUR_PAT'
Response
200 OK returns an array of events, newest first. The endpoint currently returns the complete retained history without pagination.
[
{
"id": 1000,
"date": "2026-10-03 14:00",
"status": "Error",
"tracking_id": null,
"email_tracking": false,
"legacy_email": false,
"updated_at": "2026-10-03T14:00:00Z",
"data": { "submission_id": 1234, "message": "Connection failed" },
"can_retry": true,
"retry_unavailable_reason": null
}
]
data object contains the submission ID and any failure details. Tracked emails also include recipient outcomes. Accepted means that the mail transport accepted the email; delivery is not yet confirmed. Skipped means that no request was sent because integration conditions were not met.
Use can_retry to determine whether an event is eligible for manual retry. When retry is unavailable, retry_unavailable_reason explains why. Only the latest eligible failed attempt for an available completed submission can be retried. The integration must be active.
Error responses
401 Unauthorized: authentication is missing or invalid.403 Forbidden: insufficient integration management permissions or workspace write access.404 Not Found: the form or integration does not exist in the requested scope.
Authorizations
Personal Access Token
Path Parameters
The ID of the form.
The ID of the integration.
Response
Successful
Event date formatted as YYYY-MM-DD HH:mm.
Available options:
Success, Error, Skipped, Processing, Accepted, Delivered, Unknown Submission ID, failure details, or email recipient outcomes.
Whether this is the latest eligible failed attempt for an available completed submission.
Why retry is unavailable; null when eligible.
Was this page helpful?