API ReferenceTriggersGmail Triggers

List Project Gmail Trigger Events

List delivery events for every Gmail inbox trigger in the project, newest first. Filter with target_type.

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

Query parameters

cursorstring or nullOptional

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

statusstring or nullOptional

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

target_typeenum or nullOptional

Return only events whose trigger targets a task or a task_agent. Required when target_id is supplied.

Allowed values:
target_idstring or nullOptionalformat: "uuid"

Return only events whose trigger fires this Task or TaskAgent id. Supplying it without target_type answers 400.

Response

Successfully retrieved Gmail trigger events
resultslist of objects
The list of items returned for the current page.
paginationobject or nullOptional
Contains pagination information for the result set.

Errors

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