Skip to content

List webhook events

GET /webhook-event

Query Parameters

environment_idstring · uuid

The environment whose events to list. Required when you call with a dashboard session; an API token uses its own environment.

webhook_idstring · uuid

Only events for this webhook.

eventstring

Only events of this type.

Example: integrated_account:created
statusstring

Only events in this state.

Possible values:
pendingfaileddelivered
created_atobject

A window on when the events were created, created_at[gt] and created_at[lt].

Example: {"gt":"2026-11-01T00:00:00Z"}
gtstring · date-time

Only events created after this time (ISO 8601, compared to the second).

ltstring · date-time

Only events created before this time (ISO 8601, compared to the second).

limitinteger

The most events to return.

next_cursorstring

The next_cursor from the previous page.

Show Truto-specific parameters
integrated_account_idstring · uuid

Only events about this integrated account.

Response Body

limitnumber
next_cursorstring

Pass this as next_cursor for the next page; null on the last page.

resultobject[]
attemptsinteger

Delivery attempts since the event was created or last resent.

Example: 1
created_atstring · date-time

When Truto stored the event, to the second.

Example: 2026-11-09T10:00:00.000Z
delivered_atstring · date-time

When your endpoint accepted the event.

Example: 2026-11-09T10:00:01.000Z
endpoint_statusinteger

The HTTP status your endpoint answered on the last attempt. Null when it did not answer (a timeout or a connection error) or no attempt has been made.

Example: 200
eventstring

The event type.

Example: integrated_account:created
failed_atstring · date-time

When the event was marked failed.

idstring · uuid

The event's ID, the same id your endpoint receives in the payload. A resend keeps it, so you can deduplicate on it.

Example: 6f1c1d4e-8a1b-5c2d-9e3f-4a5b6c7d8e9f
integrated_account_idstring · uuid

The integrated account the event is about, when it is about one. Null for events stored before this field existed.

Example: 94801e49-a652-42f9-af14-dd203d7897da
last_errorstring

Why the last attempt failed. Null once the event is delivered.

Example: Webhook endpoint returned 503
payloadRecord<string, any>

The event as it was or will be sent: the JSON body your endpoint receives. X-Truto-Signature signs it with the webhook's secret at the time it is sent.

statusstring

pending: waiting for its first attempt, a retry, or a resend. failed: it was not delivered: every attempt failed, its five-minute retry window ran out, or your endpoint answered 400, 404 or 413, which are not retried. You can resend it. delivered: your endpoint answered with a 2xx.

Example: delivered
Possible values:
pendingfaileddelivered
webhook_idstring · uuid

The webhook the event is for.

Example: 4a4de828-f4db-4c9e-adfd-434e0864c3c7
curl -X GET 'https://api.truto.one/webhook-event' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.truto.one/webhook-event', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/webhook-event"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
}

response = requests.get(url, headers=headers, params=params)
print(response.json())