Skip to main content

Common Errors

Workspace limit reached​

Your account has reached the maximum number of workspaces your plan allows you to own. Either delete a workspace you no longer need or upgrade to a plan with a higher workspace allowance.

Member limit reached​

The workspace has reached the maximum number of members allowed on the current plan. Remove an existing member or upgrade the workspace's plan to invite more collaborators.

Checklist not completing​

If the strategy still cannot be saved, check the checklist in SMITH. Common blockers are:

  • No initial state
  • Fewer than two states
  • A state has no outgoing transitions
  • Strategy activation settings need attention
  • A legacy trigger still needs upgrade

Data source is active but no events arrive​

If the source exists but your strategy is still not receiving data:

  1. Verify the webhook URL is the one generated by FORJ.
  2. Verify the secret token is included correctly.
  3. Confirm the provider is actually sending requests.
  4. Re-run the mapping test in the source configuration if you recently changed the payload shape.

"Invalid token" on webhook​

The token sent by the provider does not match the one FORJ generated for the data source. Copy the token again from the source details and update the external provider.

Strategy not processing events​

If a strategy is enabled but nothing happens:

  1. Confirm the data source is still Active.
  2. Confirm the strategy is subscribed to the correct stream in Subscribing Strategies to Streams.
  3. Confirm the relevant transitions use triggers that match the arriving event type.
  4. If the strategy receives events but never changes state, inspect guards and actions rather than the subscription layer.

Alerts not arriving​

If a strategy alert definition exists but you are not receiving notifications:

  1. Confirm an alert subscription matches the alert kind and severity.
  2. Confirm the definition allows the delivery channel you expect.
  3. Check Alert Activity to see whether the alert triggered and whether delivery failed later.

Strategy disabled because of an infinite transition loop​

FORJ disables strategies that contain an endless always-trigger cycle.

To fix it:

  1. Open the strategy in SMITH.
  2. Use the checklist and transition inspector to find the loop.
  3. Replace at least one always-transition in the cycle with an event-based or properly guarded path.
  4. Save the strategy.
  5. Re-enable it from HEARTH.

See Strategy Anti-Patterns.