App triggers

Trigger agents when installed apps send webhook events. Sync products from Shopify, react to Stripe payments, and more.

App triggers fire an agent when an external service sends an event to your project. When you install an app that supports webhooks, its events become available as triggers in the Agent Builder.

How it works

1. Install an app (e.g., Shopify) from the dashboard
2. Webhooks are automatically registered with the provider
3. Create an agent with the app’s webhook event as the trigger
4. When the event fires, your agent runs with the webhook payload

Shopify product updated → webhook received → agent runs → syncs product to your store

Available events

Each app declares the webhook events it supports. After installing an app, its events appear in the Agent Builder. Examples:

App	Event	Description
Shopify	orders/create	A new order is placed
Shopify	products/update	A product is modified
Shopify	customers/create	A new customer is created
Shopify	inventory_levels/update	Inventory changes for a variant

Use get_workflow_context to see all available webhook events from your installed apps.

Accessing webhook data

The full webhook payload from the provider is available via data access variables:

{{trigger_data.payload.id}}
{{trigger_data.payload.title}}
{{trigger_data.payload.email}}

The exact fields depend on the provider and event type. Use get_workflow_schema with the event ID to see available payload fields.

Verification

All incoming webhooks are verified before processing. Each app’s manifest declares its verification method (HMAC signature, certificate, etc.). Invalid webhooks are rejected and logged.

Deduplication

Webhook events are deduplicated using Temporal workflow IDs. If a provider delivers the same event twice, the second delivery is ignored.

Differences from event triggers

	Event triggers	App webhook triggers
Source	Internal commerce events	External app webhooks
Payload	Colossal data model	Raw provider payload
Setup	Available by default	Requires app install
Events	ORDER_CREATED, etc.	shopify/products.update, etc.

Some app events have platform-level handlers that emit internal events. For example, a payment webhook might emit PAYMENT_SUCCEEDED as an internal event. In those cases, use the internal event trigger instead of the raw webhook.