Skip to main content

Alert Subscriptions

Subscriptions control which emitted alerts reach you and how.

Think of it this way:

  • Strategy authors create Alert Definitions (what can emit)
  • Users create Alert Subscriptions (what they want to receive)

You can subscribe at the workspace level (all strategies) or target specific strategies, then choose channels and filters.

Managing Subscriptions

  1. Open the sidebar.
  2. Click Alert Subscriptions.

The subscriptions panel shows your active subscriptions and lets you create new ones.

What Subscriptions Match Against

Subscriptions are matched against each emitted alert's metadata, including:

  • Strategy scope
  • Alert kind (Event, Condition, Action, Transition)
  • Severity

If a subscription matches, FORJ creates an AlertDelivery for that subscriber/channel.

Creating a Subscription

A subscription specifies:

SettingDescription
ScopeWorkspace-wide (all strategies) or a specific strategy
Alert kindsWhich trigger types to subscribe to (Event, Condition, Action, Transition)
Severity filterMinimum severity level — only alerts at or above this severity are delivered
ChannelsWhich delivery channels to use (in-app, email, SMS, webhook)

Channel Configuration

In-App

Alerts appear in the alert center (notification bell in the top bar). They're delivered in real-time — you'll see them instantly without refreshing.

Email

Alerts are sent to your account email. Useful for important signals you need to see even when you're not in the app.

Webhook

Alerts are sent as HTTP POST requests to a URL you specify. This is the primary integration point for routing strategy signals to external systems like copy traders, Telegram bots, or custom dashboards.

SMS

Text message notifications for high-priority alerts.

Multiple Subscriptions

You can create multiple subscriptions with different configurations. For example:

  • Workspace-wide, in-app only, all severities — see everything in the app
  • Specific strategy, email + webhook, high severity only — get email and webhook pings only for critical trade signals from your main strategy