Triggers - Terse

Triggers define the event that starts your workflow. Each trigger is tied to an integration and fires when a specific event occurs. Your onTrigger handler receives a typed event object with the payload.

Integration triggers

GitHub

Trigger	Event type	Description
`GitHub.onPROpened()`	`GithubPRInputEvent`	A pull request is opened
`GitHub.onPush()`	`GithubPushInputEvent`	Code is pushed to a branch
`GitHub.onIssueCreated()`	`GithubInputEvent`	An issue is created

Config: Scoped to specific repositories via repo parameter.

triggers: [GitHub.onPROpened({ repo: Repos.MyOrg.MyRepo })]

Show Event payload

All GitHub events include:

repository - { id, name, owner, defaultBranch }
sender - { login, email }
commits - array of { sha, message, fileDiffs: [{ filename, diff }] }

PR events add:

pullRequest - { number, title, body, state, merged, head, base, author, url }

Push events add:

branch - the branch that was pushed to

Slack

Trigger	Event type	Description
`Slack.onMessage()`	`SlackMessageEvent`	A message is posted in a channel
`Slack.onDm()`	`SlackMessageEvent`	A direct message is received

Config: Scoped to specific channels or users.

triggers: [Slack.onMessage({ channel: SlackChannel.Engineering })]

Show Event payload

channelId, channelName - where the message was posted
userId, userName - who sent it
text - message content
timestamp, threadTs - message timing and thread parent
channelType - "channel", "group", "mpim", or "im"
files - array of attached files with { id, name, mimetype, url_private }
attachments - rich message attachments

Linear

Trigger	Event type	Description
`Linear.onIssueCreated()`	`LinearEvent`	An issue is created
`Linear.onIssueUpdated()`	`LinearEvent`	An issue is updated

Config: Optionally scoped to a specific project.

triggers: [Linear.onIssueCreated({ project: LinearProject.Backend })]

Show Event payload

data.action - "created" or "updated"
data.actor - { name, email }
data.data - issue details: { id, identifier, title, description, priorityLabel, state, team, assignee, labels, url }

Attio

Trigger	Event type	Description
`Attio.onRecordCreated()`	`AttioRecordInputEvent`	A record is created in a list

Config: Scoped to a specific Attio list.

triggers: [Attio.onRecordCreated({ list: AttioList.Pipeline.NewDeals })]

Jira

Trigger	Event type	Description
`Jira.onIssueCreated()`	`JiraEvent`	A Jira issue is created
`Jira.onIssueUpdated()`	`JiraEvent`	A Jira issue is updated

Config: Optionally scoped to a specific project.

triggers: [Jira.onIssueCreated({ project: JiraProject.Backend })]

Show Event payload

data.user - { displayName, emailAddress }
data.issue - { key, fields: { summary, description, status, priority, project, issuetype, assignee, labels } }
data.comment - present on comment events: { author, created, body }
data.changelog - present on updates: { items: [{ field, fromString, toString }] }

Gmail

Trigger	Event type	Description
`Gmail.onNewEmail()`	`GmailEvent`	A new email is received

triggers: [Gmail.onNewEmail()]

Show Event payload

data.subject - email subject
data.from, data.to - sender and recipient
data.body - email body
data.snippet - short preview
data.threadId, data.messageId - for threading
data.attachments - array of { filename, mimeType, data }

Figma

Trigger	Event type	Description
`Figma.onFileComment()`	`FigmaCommentEvent`	A comment is added to a Figma file

Config: Scoped to a specific file key.

triggers: [Figma.onFileComment({ fileKey: "abc123" })]

Show Event payload

data.fileKey - the Figma file
data.commentId, data.message - the comment
data.author - { handle }
data.imageUrls - { nodeImage, fullFrame } screenshots of the commented area
data.thread - full comment thread with { id, author, message, resolvedAt }

WorkOS

Trigger	Event type	Description
`WorkOS.onEvent()`	`WorkOSInputEvent`	A WorkOS event occurs

Config: Filtered by event types (user.created, organization.created, organization_membership.created, invitation.created, etc.).

triggers: [WorkOS.onEvent({ eventTypes: ["user.created"] })]

Show Event payload

eventId, createdAt - event metadata
user - present on user events: { id, email, firstName, lastName }
membership - present on membership events: { id, userId, organizationId, role, status }
invitation - present on invitation events: { id, email, organizationId, state }
organization - present on organization events: { id, name }

System triggers

Schedule

Trigger	Event type	Description
`Schedule.cron()`	`CronJobInputEvent`	Fires on a cron schedule

triggers: [Schedule.cron("0 9 * * 1")] // Every Monday at 9am

Show Event payload

data.isManualTrigger - whether the run was triggered manually from the dashboard
data.manualContext - optional context string provided on manual triggers

Webhook

Trigger	Event type	Description
`Webhook.onRequest()`	`WebhookEvent`	Fires when an HTTP request hits the generated webhook URL

Webhook URLs are auto-generated on deploy and remain stable across redeploys.

triggers: [Webhook.onRequest()]

Show Event payload

body - the raw JSON payload
headers - HTTP headers
method - HTTP method (GET, POST, etc.)

Common event interface

All events implement a shared interface:

interface InputEvent {
  readonly integrationType: string
  readonly eventType: string
  formatForAgentRunner(): string  // Formats the event for LLM consumption
}

In TypeScript, call event.formatForAgentRunner() to get a string representation suitable for including in prompts. In Python, use event.formatted_content.

Getting started

​Integration triggers

​GitHub

​Slack

​Linear

​Attio

​Jira

​Gmail

​Figma

​WorkOS

​System triggers

​Schedule

​Webhook

​Common event interface

Integration triggers

GitHub

Slack

Linear

Attio

Jira

Gmail

Figma

WorkOS

System triggers

Schedule

Webhook

Common event interface