App events

Run workflows when connected apps emit events.

A common goal is “run this when something happens in another app,” such as a new GitHub issue, a paid Stripe invoice, or a Linear status change. Keystroke doesn’t have a separate app-event trigger type; instead you react to app events with the trigger sources you already have, pointed at the app. This page covers the patterns.

There’s no defineAppEventSource. The three sources (webhook, schedule, and poll) cover app events. Pick the one that matches how the app delivers events.

When the app sends webhooks

Most modern apps can push events to a URL. This is the best option when it’s available: point the app’s webhook at a webhook trigger.

1. Define a defineWebhookSource with a payload schema for the app’s event.
2. Get the URL with keystroke triggers url <endpoint> and register it in the app’s settings.
3. Put event-type constraints (literals, enums) in the payload schema so only the events you care about fire.

src/triggers/stripe-invoice-paid.ts

import { defineWebhookSource } from "@keystrokehq/keystroke/trigger";
import { z } from "zod";
import workflow from "../workflows/invoice-paid";

export default defineWebhookSource({
  slug: "stripe-invoice-paid",
  name: "Stripe invoice paid",
  description: "Fires when Stripe sends an invoice.paid event.",
  endpoint: "stripe",
  payload: z.object({
    type: z.literal("invoice.paid"),
    data: z.object({ id: z.string() }),
  }),
}).attach({
  workflow,
  transform: (payload) => ({ invoiceId: payload.data.id }),
});

Providers that send every event type to one URL fit the shared endpoint pattern: many triggers on a single endpoint, each with its own payload for its event.

When the app doesn’t push events

If an app has no webhooks (or you’d rather pull), use a poll trigger. Its run() checks the app’s API on a schedule and starts a run only when there’s something new:

src/triggers/new-issues.ts

import { definePollSource } from "@keystrokehq/keystroke/trigger";
import workflow from "../workflows/handle-issue";

export default definePollSource({
  slug: "new-issues",
  name: "New issues",
  description: "Polls for open issues every ten minutes.",
  schedule: "*/10 * * * *",
  run: async () => fetchOpenIssues(),
  filter: (result) => result.issues.length > 0,
}).attach({ workflow });

When the source you’re polling needs credentials, resolve them through an action that you call from run(), or read them from your project’s credentials.

Chat apps: the Slack gateway

Conversations are different from events. To let people talk to an agent from Slack (mention it in a channel or DM it), connect the Keystroke Slack App (keystroke connect slack --kind keystroke; catalog slug slackbot) and use the Slack gateway rather than a trigger. The gateway delivers inbound messages to an agent and posts replies back as the bot. See external channels.

Finding integrations

Keystroke ships 1,000+ integrations. Each one lists the actions it provides (and whether it exposes triggers), which you can use inside a poll’s run() or as steps and tools once connected. Browse the catalog to see what’s available for the app you want to react to, then wire it up with a webhook or poll as above.

Next steps

Webhooks

Receive events the app pushes to a URL.

Polling

Pull events from an app on a schedule.

External channels

Connect agents to Slack and other chat surfaces.

Integrations

Browse 1,000+ built-in integrations.