# Flowmage Docs

> How to build, run and fix flows in Flowmage, with a reference for every node, function and error.

- [Add nodes and link them](https://docs.flowmage.com/build/adding-and-wiring-steps.md): Add nodes from Add a step, link them with edges, put a node between two others, and change a node from its menu.
- [Call another flow](https://docs.flowmage.com/build/calling-another-flow.md): Let one flow call another like a function: give the called flow its inputs, and call it from a Subflow node with your values.
- [Send a run down different paths](https://docs.flowmage.com/build/conditions.md): Use a Condition to take one path when a check is true and another when it is false, or a Switch to take one path for each value you list.
- [The editor](https://docs.flowmage.com/build/editor.md): The editor is where you build a flow, on a canvas of linked nodes, with its controls, its grid, notes and issue list, under a header for the flow's name, views and publishing.
- [Import and export](https://docs.flowmage.com/build/import-export.md): Save a flow as a .flowmage.json file and bring it into this or another workspace as a new draft, with a check of what it needs there.
- [Build flows](https://docs.flowmage.com/build.md): Build a flow in the editor, from adding and linking nodes and using earlier data to branches, loops, failures, testing and publishing.
- [Keyboard shortcuts](https://docs.flowmage.com/build/keyboard-shortcuts.md): Every key the flow editor answers, on Mac and Windows, on the canvas, in Add a step, in a node's dialog and on a sticky note.
- [Repeat nodes for each item in a list](https://docs.flowmage.com/build/lists-and-loops.md): Use a Loop to run the same nodes once for every item in a list, read the current item, end early with Break, and see each round in the run.
- [Manage your flows](https://docs.flowmage.com/build/managing-flows.md): Find a flow on the Flows page, sort and narrow the list, pin, rename, duplicate or delete a flow, and set its tags, alerts and run history.
- [How data moves between nodes](https://docs.flowmage.com/build/passing-data.md): Each node receives what the node before it gave back. See it in the node's dialog, put it in a field with an expression, and check the result.
- [Publish to Test and Prod](https://docs.flowmage.com/build/publishing.md): Put your draft on Test as a new version, put a version you tried on Prod for real traffic, see what Prod runs, and roll back after a mistake.
- [Start from a template](https://docs.flowmage.com/build/templates.md): Start a flow from one of six ready-made templates: pick one, let Flowmage check what it needs in your workspace, and change it from there.
- [Test a flow](https://docs.flowmage.com/build/testing.md): Try a flow while you build it: set the data it starts with, test one node, pin or edit its output, and run the whole draft with Test run.
- [Make a flow wait or ask for approval](https://docs.flowmage.com/build/waiting-and-approvals.md): Pause a flow with a Wait, a Wait for signal or an Ask for approval node, then let the run go on: by itself, with Resume now, or when someone decides.
- [Recover from a failed step](https://docs.flowmage.com/build/when-a-step-fails.md): Choose what happens when a node fails in a run: stop the flow, carry on with the error, try it again, or catch it with a Try/Catch node and go on.
- [Connect a service](https://docs.flowmage.com/connections/connect.md): Add a connection so your flows can reach a service such as AFAS Profit: pick the service, fill in its details, save them, then add the Prod credentials.
- [When a connection stops working](https://docs.flowmage.com/connections/fix-a-connection.md): A run fails on a node that uses a connection. Most often the service no longer accepts the saved credentials: type them again for that environment.
- [Connections](https://docs.flowmage.com/connections.md): A connection holds the details Flowmage needs to reach one service, with separate credentials for Test and Prod. A secret keeps one value, such as a token.
- [Add a secret](https://docs.flowmage.com/connections/secrets.md): Keep a token or a password for your flows as a secret: write-only, with an optional different value for Prod, used in any field as secret.NAME.
- [Store a file](https://docs.flowmage.com/data/files.md): Upload a file, such as a price list or a template, to your workspace, keep it in a folder, and read it in a flow. Each file belongs to one environment.
- [Data](https://docs.flowmage.com/data.md): Keep data in your workspace for your flows: rows in tables, settings in schemas and documents in files, each kept apart for Test and Prod.
- [Keep settings in a schema](https://docs.flowmage.com/data/schemas.md): Keep a JSON document, such as shipping rates, that several flows read: make it in Test, change it in its editor, and copy it to Prod.
- [Store data in a table](https://docs.flowmage.com/data/tables.md): Make a table with typed columns in Test, add rows, and let your flows insert, find and change rows with the Tables nodes. Put it on Prod when it is ready.
- [Build flows with AI](https://docs.flowmage.com/developers/build-with-ai.md): Download the flowmage-flows skill, add it to Claude or paste it into another AI tool, and import the flow file it writes into your workspace.
- [The flow file](https://docs.flowmage.com/developers/flow-file.md): The .flowmage.json file that Export writes and Import reads: its keys, what it needs from a workspace, and what import does with it.
- [Developers](https://docs.flowmage.com/developers.md): For the developer who sends data to a Flowmage webhook, writes a flow file by hand, or has an AI tool write flows.
- [Webhooks](https://docs.flowmage.com/developers/webhooks.md): What a system sends to a Flowmage webhook, what it gets back, and what the flow receives: method, headers, keys, signatures, status codes and the trigger payload.
- [What an expression can read](https://docs.flowmage.com/expressions/earlier-steps.md): Every name an expression starts with, from json and node["Name"] to trigger and secret, and how to write the path to one field.
- [Expressions](https://docs.flowmage.com/expressions.md): Fill a node's field from the run's own data: the trigger, an earlier step's output, a secret or a function's result, worked out each time the node runs.
- [Dates, text and lists recipes](https://docs.flowmage.com/expressions/recipes.md): Ready-made expressions for the jobs flows do most: format a date, tidy up a name or an e-mail address, count a list or join it into one line.
- [When an expression fails](https://docs.flowmage.com/expressions/when-it-fails.md): An expression shows a red message, or a run fails with EXPRESSION_ERROR. Find the message here, most likely first, and change the field to fix it.
- [Write an expression](https://docs.flowmage.com/expressions/writing.md): Fill a node's field from the run's data: pick a value in the Input pane, change it with a function, and see what the field holds before the flow runs.
- [Get an email when something goes wrong](https://docs.flowmage.com/runs/alerts.md): Set an alert so Flowmage emails you and your colleagues when a run fails, a run takes too long, a connection stops working or a flow goes quiet.
- [Answer an approval](https://docs.flowmage.com/runs/approvals.md): Decide a request a flow is waiting on: open it under Approvals, read what it asks, and pick an option. The run goes on down the path you chose.
- [Error lookup](https://docs.flowmage.com/runs/error-lookup.md): Find an error from a failed run by its code or its sentence, and read what causes it and what to do next on its errors page.
- [Fix a failed run](https://docs.flowmage.com/runs/fix-a-failed-run.md): A run failed. Read the sentence its failed step gives, fix what it names, then re-run it with Retry… or try your fix with Test run.
- [Runs](https://docs.flowmage.com/runs.md): Each time a flow starts, Flowmage keeps a run of it. Read what a run did, fix one that failed, get an email when one fails and answer approvals.
- [Reading a run](https://docs.flowmage.com/runs/reading-a-run.md): A run is one pass of a flow. Find it on Runs, then read its graph and its steps: what each one ran with, what came back, and why one failed.
- [Sign up and sign in](https://docs.flowmage.com/start/account.md): Accept your invitation to Flowmage, verify your email address, add a second sign-in step, and sign in again later with a password, passkey, Microsoft or Google.
- [Build your first flow](https://docs.flowmage.com/start/first-flow.md): Make a flow from a template that saves what a webhook sends to a table, run it once from the editor and find the run it left.
- [How Flowmage works](https://docs.flowmage.com/start/how-flowmage-works.md): A trigger starts a flow, its nodes do the work one step at a time, and Flowmage keeps every run so you can see what happened and why.
- [Get started](https://docs.flowmage.com/start.md): New to Flowmage? See how a flow works, accept your invitation, find your way around the screens and build a first flow that runs.
- [A tour of Flowmage](https://docs.flowmage.com/start/tour.md): Find your way around Flowmage, from the sidebar and Home to the search, the workspace switcher and the switch between Test and Prod.
- [Words you will meet](https://docs.flowmage.com/start/words.md): The words Flowmage uses on its screens and in these pages, each with one meaning and the place you first meet it, from organization to re-run.
- [Start a flow from Stripe or AFAS Profit](https://docs.flowmage.com/triggers/apps.md): Make a trigger on a connected Stripe or AFAS Profit, so a flow starts the moment the service sends an event, such as a paid invoice or an updated dossier.
- [Start a flow on a workspace event](https://docs.flowmage.com/triggers/event.md): Make a workspace event trigger so a flow starts when something happens in Flowmage: a run fails, an alert fires, a connection stops working, a file is added.
- [How triggers start flows](https://docs.flowmage.com/triggers/how-triggers-work.md): A trigger starts your flows when something happens: a webhook is called, a schedule's time comes, or something changes in your workspace or a connected service. Several flows can be on one trigger.
- [Triggers](https://docs.flowmage.com/triggers.md): What starts a flow: you pressing Test run, a webhook, a schedule, something in your workspace, or a change in an app such as Stripe, AFAS Profit or Asana.
- [Run a flow by hand](https://docs.flowmage.com/triggers/manual.md): Press Test run in the editor to run your draft once, right away, with no trigger, and find that run on the flow's Runs tab.
- [Run a flow on a schedule](https://docs.flowmage.com/triggers/schedule.md): Give a flow a schedule so it runs by itself at the times you set, such as every weekday at 09:00, in your workspace's timezone.
- [Watch a list for changes](https://docs.flowmage.com/triggers/watch.md): Make a watch on a list in AFAS Profit or Asana, so a flow starts each time a row in it is added, changes or is removed, and gets the row and what changed.
- [Start a flow from a webhook](https://docs.flowmage.com/triggers/webhook.md): Give a flow a webhook: a private link that starts a run each time another system sends a POST request to it, with the request as the run's input.
- [Test and Prod](https://docs.flowmage.com/workspace/environments.md): Every workspace has two environments: Test, where you build and try flows, and Prod, where the flows your business relies on run, apart from your tries.
- [Workspace](https://docs.flowmage.com/workspace.md): Who can do what in your workspace, how Test and Prod keep your tries apart from your real runs, what your runs use, and your own profile.
- [Invite members and choose their roles](https://docs.flowmage.com/workspace/members-and-roles.md): Invite a colleague to your organization, pick their role and the workspace they join, and add them to more workspaces. Only admins can change Prod.
- [Add and set up a workspace](https://docs.flowmage.com/workspace/organizations-and-workspaces.md): Add a workspace to your organization, switch to it from the top bar, and set its name, picture and timezone. Each workspace has its own flows and members.
- [Usage and tasks](https://docs.flowmage.com/workspace/usage.md): Flowmage counts what your runs use in tasks: one attempt at one step. See this month's tasks for Test and Prod, and how your workspace's runs went.
- [Change your profile and sign-in](https://docs.flowmage.com/workspace/your-account.md): Change your name, photo, email address and time zone, your password, two-factor authentication and passkeys, sign out other sessions, and pick a theme.