API ReferenceTriggersGmail Triggers

List Gmail Trigger Events

List delivery events for one Gmail inbox trigger, newest first. Each event records the message that arrived and what the trigger did with it.

This returns a plain array, not a paginated envelope — unlike the project-wide event list.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

OR
AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"
The organization ID
project_idstringRequiredformat: "uuid"
The project ID
trigger_idstringRequiredformat: "uuid"

Query parameters

limitintegerOptional1-100Defaults to 100
Maximum number of events to return.
cursorstring or nullOptionalformat: "uuid"
Return only events whose id is below this value. Pass the id of the last event from the previous page.
statusstring or nullOptional

Return only events in this state: received, processing, approval_required, completed, failed, duplicate or skipped. Any other value answers 400.

Response

Successfully retrieved events for this Gmail inbox trigger
idstringformat: "uuid"
gmail_inbox_trigger_idstringformat: "uuid"
gmail_message_idstring
history_idstring
email_addressstring
statusenum
received_atstring
gmail_notification_idstring or nullOptionalformat: "uuid"
gmail_thread_idstring or nullOptional
error_codestring or nullOptional
error_messagestring or nullOptional
task_run_idstring or nullOptionalformat: "uuid"
task_agent_run_idstring or nullOptionalformat: "uuid"
processing_started_atstring or nullOptional
completed_atstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error