veryfront__list_webhook_eventsAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug. |
webhook_id | string | Yes | The webhook id (id on the webhook, formerly webhook_definition_id). A missing webhook is not found. Format: uuid. |
limit | integer | No | Maximum webhook events to return, from 1 to 100. Defaults to 50. Minimum: 1. Maximum: 100. |
cursor | string | No | The page_info.next of the previous page: the id of its last webhook event. Keep sort_order the same across pages. Format: uuid. |
sort_order | string | No | Creation order: desc (newest first, the default) or asc. Values: "asc", "desc". |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_webhook_events",
"arguments": {
"webhook_id": "00000000-0000-4000-8000-000000000000"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data | object[] | Yes | Primary record collection. |
page_info | object | Yes | Pagination cursor values for traversing the result set. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug."
},
"webhook_id": {
"type": "string",
"format": "uuid",
"description": "The webhook id (`id` on the webhook, formerly `webhook_definition_id`). A missing webhook is not found."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum webhook events to return, from 1 to 100. Defaults to 50."
},
"cursor": {
"type": "string",
"format": "uuid",
"description": "The `page_info.next` of the previous page: the id of its last webhook event. Keep `sort_order` the same across pages."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Creation order: desc (newest first, the default) or asc."
}
},
"required": [
"webhook_id"
],
"additionalProperties": false,
"description": "Structured list webhook events input schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The webhook event id. Every stored event has one, including events filtered before execution; pass it as webhook_event_id to replayWebhookEvent."
},
"webhook_id": {
"type": "string",
"format": "uuid",
"description": "The id of the webhook that received the event."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with the record."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with the record."
},
"message_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The message id associated with this record."
},
{
"type": "null",
"description": "The message id returned by the tool."
}
],
"description": "The message id associated with this record."
},
"run_id": {
"type": [
"string",
"null"
],
"description": "Associated execution, or null when the event started none."
},
"canonical_run_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The canonical run id associated with this record."
},
{
"type": "null",
"description": "The canonical run id returned by the tool."
}
],
"description": "The canonical run id associated with this record."
},
"latest_event_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "The latest event id associated with this record."
},
{
"type": "null",
"description": "The latest event id returned by the tool."
}
],
"description": "The latest event id associated with this record."
},
"status": {
"type": "string",
"enum": [
"received",
"queued",
"running",
"completed",
"failed",
"cancelled",
"ignored"
],
"description": "Lifecycle status for the record."
},
"duplicate": {
"type": "boolean",
"description": "Whether the record represents a duplicate."
},
"payload": {
"description": "The payload associated with this record."
},
"error_code": {
"type": [
"string",
"null"
],
"description": "The error code associated with this record."
},
"error_message": {
"type": [
"string",
"null"
],
"description": "The error message associated with this record."
},
"invoked_by": {
"type": [
"string",
"null"
],
"description": "The invoked by associated with this record."
},
"manual_invoked_by_user_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The manual invoked by user id associated with this record."
},
{
"type": "null",
"description": "The manual invoked by user id returned by the tool."
}
],
"description": "The manual invoked by user id associated with this record."
},
"received_at": {
"type": [
"string",
"null"
],
"description": "The received at associated with this record."
},
"completed_at": {
"type": [
"string",
"null"
],
"description": "The completed at associated with this record."
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
}
},
"required": [
"id",
"webhook_id",
"project_id",
"conversation_id",
"message_id",
"run_id",
"canonical_run_id",
"latest_event_id",
"status",
"duplicate",
"error_code",
"error_message",
"invoked_by",
"manual_invoked_by_user_id",
"received_at",
"completed_at",
"created_at"
],
"additionalProperties": false,
"description": "One data item associated with this record."
},
"description": "Primary record collection."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "null",
"description": "The first associated with this record."
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "A page of webhook events, newest first by default.",
"$schema": "http://json-schema.org/draft-07/schema#"
}