Subscribe a Workflow or Agent to an Event

A subscription binds an event source to a workflow or agent. Each subscription is org-scoped and maps fields from the inbound payload into the workflow or agent input.

Subscriptions can also narrow the stream with an optional event-type filter and a payload filter. Both are evaluated before Bifrost queues a delivery, so non-matching events are skipped instead of fanning out.

Workflow vs Agent Targets

Target	When to use
Workflow	Deterministic logic — log a ticket, update a record, fan out to other systems.
Agent	LLM-driven triage — classify the event, decide a route, draft a response. The full payload is exposed as _event in the agent’s context.

Add a Subscription

1. Open the event source and click Add Subscription.

   

2. Pick Workflow or Agent, choose the target, and map payload fields into the target’s input parameters using {{ payload.<field> }} expressions.

   

3. Save. The next inbound event matching this source dispatches the target. Recent deliveries appear in the source’s delivery log.

Tip

The full event metadata is always available as _event in the workflow or agent context, even if you only mapped specific fields as inputs. See Webhook & Event Variables for the full reference.

Next Steps

• Webhook HMAC Authentication — verify the request before dispatching.
• Webhook & Event Variables — payload reference and template expressions.