How to Setup a Configuration Flow

Configuration flows in Fastn allow you to define variables, map values, and build reusable configurations that can be used in widgets or other flows.

1. Choose a Starting Point

Every configuration flow begins with a starting step.

• This could be an event like a New API Request, or any other supported trigger.

• The starting point provides the input data that will move through the rest of the configuration flow.

2. Add a Data Mapper Step

Next, insert a Data Mapper step.

• The Data Mapper is where you configure all the variables that will be passed into your target app.

• For example, if you are building a configuration for Zapier, the key entities could include:

i. String id

ii. String connectorID

iii. Object type variable (zaps)

3. Configure Field Options

For each variable in your configuration, you can set field-level options:

• Click on the three dots next to a field.

• Under General, you can:

  • Add a Label (this appears in the widget UI).

  • Disable the field.

  • Hide the field in the configuration pop-up.

  • Conditionally hide the field based on another field’s value.

• Under Selections, you can:

  • Enable selections.

  • Mark the field as independent.

  • Define the Selection Type:

    • Static – Predefined list of options.

    • Dynamic – Options fetched at runtime from another flow.

    • Custom – User-defined logic.

These options control how fields appear in your widget and how end-users interact with them.

4. Configure Flow Selections

You can also enable flow-based selections.

• For example, you might let users select from Community Selection Flows or Workspace Selection Flows.

• The data returned by these flows can be paginated to handle large sets of results.

5. Set Pagination Rules

When working with data-heavy flows, configure pagination:

• Pagination Type:

  • Cursor – Uses a pointer to fetch data chunks.

  • Offset – Uses index-based offsets.

• Limit: Defines the maximum number of records retrieved per chunk.

Use Configuration Flows in Widgets or Other Flows

Once created, configuration flows can be reused:

• Embed them in Widgets – End-users can interact with your configuration inside the UI.

• Include in Other Flows – Useful wherever mapping or variable selection is needed.

With this setup, you now have a complete configuration flow that manages variables, supports field-level options, handles pagination, and integrates into widgets or other flows.