Installation and Setup

FlowMint Workflows installs like any plugin, after Promptless Forms. The one setting that matters on a live site is outside the plugin: a cron job, so background runs start on time.

Requirements

Requirement	Version
WordPress	5.6 or later
PHP	8.1 or later (7.4 up to version 0.9.0)
Promptless Forms	1.8.0 or later, active
Promptless CPT Pages	Only for the record-import step: 0.9.0 or later, and 0.10.0 or later for featured images from a URL

Action Scheduler and the Google API library ship inside the plugin. The Google library is why PHP 8.1 is the minimum: WordPress refuses to install or update FlowMint on an older PHP.

How to install

1. Install and activate Promptless Forms.
2. Upload the FlowMint Workflows ZIP under Plugins → Add New Plugin → Upload Plugin, then activate it. The installation order for the whole stack is in Installing the Stack.
3. Open FlowMint Workflows → Run History. An empty list reading “No workflow runs yet.” means FlowMint is running.

If Promptless Forms is missing or older than 1.8.0, FlowMint shows a notice instead of starting. If Action Scheduler failed to load, it warns that workflows will not execute.

Make background processing reliable

Every run waits in Action Scheduler’s queue until WP-Cron fires, and WP-Cron fires only when someone loads a page. On a busy site that is every few seconds; on a quiet one a run can sit Queued for many minutes, and a scheduled workflow can miss its time.

Add a real cron job in your host’s control panel that loads wp-cron.php every minute:

* * * * * curl -s https://example.com/wp-cron.php > /dev/null 2>&1

Replace example.com with your domain. Your host may also offer its own “disable WP-Cron and use a real cron” setting; either works.

The admin screens

FlowMint adds a FlowMint Workflows menu with three screens:

Screen	What it is for
Run History	Every run, its status and each step’s result. Replay a finished run. See Run history.
Workflows	A read-only list of the workflows on the site: id, title, form, enabled, who manages it, version, last update.
Connector	Turn the connector on and set up an AI assistant. See Connector setup.

You create and change workflows through the connector or the REST API, not on these screens.

Who can use it

The screens and the REST API need the flowmint_manage_workflows capability. Activation gives it to the Administrator role. To let another role read run history, add the capability to that role with a role-editor plugin. Developers can change the default roles with the flowmint_default_manage_workflows_roles filter (applied when the plugin is activated or its database version changes).

Limits and common problems

• Promptless Forms must store entries. A workflow runs only for a submission that was saved as an entry. A form with store_entries set to false never starts its workflow; see Creating forms.
• Deactivating FlowMint cancels waiting jobs. Runs still Queued at that moment never start, and scheduled workflows stop until FlowMint’s daily check re-creates their timers (within about an hour of reactivation, once cron runs) or you save each scheduled workflow again.
• Deleting FlowMint keeps its data. Workflows, run history and stored credentials stay, so reinstalling picks up where you left off; scheduled jobs and the connector switch are removed. To remove the data as well, add define( 'FMW_REMOVE_ALL_DATA', true ); to wp-config.php before deleting the plugin. Up to version 0.9.0 deleting always removed every workflow, run and credential.

Related pages

• What FlowMint Workflows Is — What FlowMint Workflows does, what it needs, how a workflow run happens in the background, and what it deliberately does not do.
• Your First Workflow — Build a workflow that emails your office when a contact form is submitted, test it, turn it on, and confirm the run in Run History.
• Connector Setup — Switch the FlowMint connector on, generate a connection, run the setup command on your Mac, and confirm Claude Desktop can see your workflows.
• Installing the Stack — The order to install the Promptless products, their WordPress and PHP requirements, where each one is downloaded and how it is updated.
• Installation and setup — Install and activate Promptless Forms, find its admin screens, and set the few site-wide options it has.