Account Events Tools

Tools for account-wide events and the triggers that fire flows or agents from them.

8 tools

Available Tools

accountEvents_raise

Raise a custom account event; every "On event" trigger on it (a flow, an AI agent, a function) runs

Input Schema

`name`	stringrequired	Your own event name, e.g. order_ready (recorded as custom.order_ready)
`subject`	object	What it is about
`properties`	object	Details (up to 30 keys, 8 KB)
`idempotencyKey`	string	Makes retries safe: the same key never records twice

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_raise",
    "arguments": {
          "name": "example",
          "subject": {},
          "properties": {}
    }
  }
}

accountEvents_listEventTriggers

(beta) The "On event" triggers of this account — "when <event> happens → run <flow | AI agent | function>": event pattern (a name, source.* or *), conditions, target with its name, on/off, last fired, fire count. Params: targetKind?, targetRef? to list one flow's, agent's or function's triggers.

Input Schema

`targetKind`	string
`targetRef`	string

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_listEventTriggers",
    "arguments": {
          "targetKind": "example",
          "targetRef": "example"
    }
  }
}

accountEvents_addEventTrigger

Add an "On event" trigger: the event starts a flow, an AI agent or a function

Input Schema

`name`	string	A label; made from the event and target when omitted
`event`	stringrequired	An event name (base.row_created), a source pattern (base.) or for everything
`filters`	array	Only when every filter matches the event properties (subject.name, name, source, origin are also addressable)
`targetKind`	stringrequired	flow \| agent \| account_function
`targetRef`	stringrequired	flow id \| agent id \| account function id
`config`	object

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_addEventTrigger",
    "arguments": {
          "name": "example",
          "event": "example",
          "filters": {}
    }
  }
}

accountEvents_updateEventTrigger

Change an "On event" trigger: its event, conditions, name, or on/off

Input Schema

`id`	stringrequired
`name`	string
`event`	string
`isActive`	boolean
`filters`	array
`config`	object

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_updateEventTrigger",
    "arguments": {
          "id": "example",
          "name": "example",
          "event": "example"
    }
  }
}

accountEvents_removeEventTrigger

Remove an "On event" trigger

Input Schema

id stringrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_removeEventTrigger",
    "arguments": {
          "id": "example"
    }
  }
}

accountEvents_eventTriggerRuns

What "On event" triggers did: newest first, status queued | ok | failed | skipped with the reason, attempts, the event. Params: triggerId?, limit?.

Input Schema

`triggerId`	string
`limit`	integer

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_eventTriggerRuns",
    "arguments": {
          "triggerId": "example",
          "limit": {}
    }
  }
}

accountEvents_setFlowEventTrigger

Bind a flow's Event Trigger node to an event (upsert)

Input Schema

`flowId`	stringrequired
`triggerId`	stringrequired
`event`	stringrequired
`filters`	array

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_setFlowEventTrigger",
    "arguments": {
          "flowId": "example",
          "triggerId": "example",
          "event": "example"
    }
  }
}

accountEvents_builtins

Every built-in account event name with its plain-language description, grouped by source: base (rows written by ANY lane: grid, chat, agent, MCP, API, flow, import), drive, site, flow, agent, function, email, journey, marketplace, billing, connector, channel. Your own events are custom.<name>. Use it before adding an "On event" trigger. There is no event log: what a trigger did is on the trigger (accountEvents_eventTriggerRuns).

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accountEvents_builtins",
    "arguments": {}
  }
}