Skip to content

Common issues

The problems people hit most often, and the first thing to try for each.

"I can't log in"

  1. Check the address. Make sure you are on your Flero instance, not an old bookmark.
  2. Check the email. A typo is the most common cause.
  3. Read the message. See Login messages:
    • "Please accept your invite before logging in." Open your invitation email and finish setting up.
    • "Your access has been removed. Contact your administrator." You were removed from your last workspace. An admin can add you back.
    • "Too many attempts". Wait a while before trying again.
  4. Authenticator code rejected? Your phone's clock may have drifted. Turn on automatic time in your phone's settings.
  5. Forgot your password? Use Forgot password on the sign-in page. The link is valid for 1 hour.

Invite links last 24 hours and work once. An expired or used link shows "Invitation not valid". Ask an owner or admin to click Resend invitation email. See Inviting members.

"I clicked Run but nothing happens"

  • Save first. Unsaved changes are not run.
  • Look for configuration errors on the canvas.
  • Stuck on Pending? The run is waiting for a worker. If it stays pending, contact your Flero administrator or support.
  • Is the workspace right? Check the active workspace in Settings → Workspace.

"My webhook or form doesn't start a run"

  • Activate the workflow. Webhooks and forms only run the active version. An inactive webhook answers 404 Webhook not found. See Versions and activation.
  • Check the method. A wrong HTTP method answers 405 Method not allowed.
  • Check the signature. With a Secret Key set, unsigned requests answer 401.
  • Send JSON. A body that is not valid JSON answers 400 Invalid JSON payload.

"I get [EXPR-ERROR: …] in my output"

The marker says what went wrong. The most common causes:

  • The node name in $node["..."] does not match the canvas exactly. Names are case-sensitive.
  • A shorthand like start.output.x without the $node["..."] wrapper.
  • The referenced node did not run in this execution, for example it sits on the other If branch.

See Debugging expressions.

"My expression shows up as literal text"

Expressions look values up. They do not calculate. Operators (+, ||), functions (now()) and method calls (.length) are left as text. Do the work in a Set, Data Transform or Code node. A {{ }} block without a Flero root ($node, $trigger, $input, $env, $workflow) is also left as text.

"A node fails with 'Workspace variable "NAME" is not set.'"

The workflow reads {{ $env.NAME }} and the workspace has no such variable. An owner or admin adds it under Settings → Workspace → Variables. See Workspaces.

"A node works in sandbox but fails in production"

  • Mock data differs from real responses. Record a real response as your mock so the two match. See Mock data.
  • The real credential has expired or lacks a scope. Check it under Settings → Credentials. A credential marked "Reconnect required" needs to be signed in again.
  • Rate limits. Real services throttle, mocks don't. Add retries in the node's settings.
  • Data shape varies. A field always present in mocks may be missing in real data.

See Sandbox mode troubleshooting.

"My AI node fails with 'budget exceeded'"

The workspace has spent its monthly AI limit. The owner can raise it under Settings → Workspace → AI Budgets, or wait for the next month. See AI budgets.

"A run failed with 'The worker running this execution stopped responding'"

The server running your workflow restarted or crashed mid-run. Flero closed the run instead of leaving it running forever. Nothing was re-run automatically, because some nodes may already have taken effect. Check what the run did, then use Rerun.

"My approval is stuck"

  • Nobody was told. Only Approval Type Email sends the request. With other types, the request waits in Approvals in the app.
  • Wrong address. Check the Approvers list on the node.
  • It will wait. Email and in-app approvals do not time out. Decide from Approvals, or stop the run.

See Approval basics.

"I can't see my workflow, credential or setting"

  • Wrong workspace? Switch workspace. See Switching workspaces.
  • Archived? Check the Archive tab on the Workflows page.
  • Filters on? Clear search and filters.
  • Organization tabs missing? Billing, Security, Data & Privacy and Organization are only for organization members. See Roles & permissions.
  • Can't save workspace settings? Only the workspace owner can save name, quotas and AI budgets.

"Old runs have disappeared from Logs"

Flero deletes finished executions older than the organization's retention period, 90 days by default. See Data & privacy.

"I made a change and broke production"

  1. Open the version menu in the editor header.
  2. Set the last good version to Active.
  3. Compare the versions at leisure.

See Versions and activation.

When to contact support

If the obvious fixes don't help, send support:

  • The execution ID, if there is one.
  • Steps to reproduce.
  • What you expected and what happened.
  • The exact error text, copied rather than paraphrased.

Use Help or Feedback in the sidebar profile menu.

Found something out of date? This page lives in the Flero docs content set.