tr Skip to content
Black Friday FlowMattic for life, 12 payments of $33.25 Or $399 once. Nothing added for splitting Ends in --Days --Hrs --Min --Sec See the deal

WordPress Triggers and Actions in FlowMattic: The Complete Guide

FlowMattic WordPress triggers and actions: a newly published post starts a workflow where an AI Agent writes social copy that goes to Telegram and Google Sheets.

FlowMattic’s WordPress triggers and actions start workflows from WordPress itself. The built-in WordPress app has 32 triggers, from a new post or user to a plugin update or a GDPR request, and more than 70 actions that create, update and look up posts, users, media, comments, terms, meta and options on the same site.

Because FlowMattic is an automation plugin for WordPress, these triggers listen to WordPress hooks directly. There is no connector plugin to install and nothing to poll. This guide covers every trigger and action, the options that shape them, and the workflows site owners, agencies and editors build with them.

What are FlowMattic’s WordPress triggers and actions?

They come from two core apps you’ll find in the builder’s app picker:

  • WordPress: the named triggers and actions in this guide, ready to configure.
  • Plugin Actions: one trigger, Plugin or WP action triggered, that starts a workflow from any action hook you name, including hooks from other plugins.

Sites on a network also have a separate WordPress Multisite app with triggers such as Site Created and Site Deleted.

How WordPress triggers and actions work in FlowMattic

  1. Create a workflow, add the trigger, choose WordPress and pick an event such as New Post.
  2. Set the event’s options. New Post, for example, has Run When and Post Type.
  3. On the Capture tab, click Capture Response, then do the thing in WordPress: publish a test post, register a test user, approve a comment. The real fields arrive for mapping.
  4. Add actions. WordPress actions run on the same site, so a step such as Update Post or Add Role to User takes effect straight away.
  5. Switch the workflow on. From then on the trigger fires when WordPress fires the matching hook.
FlowMattic builder showing the WordPress New Post trigger with Run When set to A new post is published and Post Type set to post.
The New Post trigger with Run When and Post Type, set to run once when a post is published.

WordPress triggers, by object

ObjectTriggers
Posts and pagesNew Post, New Page, Update Post, Update Page, User Deletes a Post, Post Meta Updated, Post Meta Field Updated, User Visits a Page/Post
MediaNew Media
CommentsNew Comment, Comment Approved
UsersNew User, User Login, User Profile Updated, User Profile Field Updated, User Resets Password, User Deleted
RolesUser Role Added, User Role Removed, User Role Changed, User Role Changed From Specific to Defined
TaxonomyCategory Created, Tag Created, Term Created
Plugins, themes, corePlugin Activated, Plugin Deactivated, Plugin Updated, Plugin Deleted, Theme Switched, WordPress Core Updated
PrivacyGDPR Export Data Request Confirmed, GDPR Erase Data Request Confirmed

WordPress actions, by object

ObjectActions
PostsNew Post, Update Post, Delete Post, Duplicate Post, Set Post Status, Set Post Thumbnail, Remove Post Thumbnail, Get Post by ID, Get Posts by Post Type, Get Posts by Metadata, Search WordPress
Post termsAdd or Remove Tag, Category or Taxonomy to a Post, Get Post Taxonomies, Get Post Taxonomy Terms
Post metaAdd Post Meta, Update Post Meta, Delete Post Meta, Get Post Metadata
MediaNew Media, Upload Base64 Image, Get Media by ID, Search Media by Title, Rename Media, Rename Media File URL, Delete Media, Create Media Folder, Move Media to Folder
CommentsNew Comment, Update Comment, Delete Comment, Get Comments
UsersNew User, Create User if Not Exists, Update User, Delete User, Get User by ID, Get User by Email, Get User by Username, Get All Users by Role, Get Users by Meta, Send Password Reset
User meta and rolesUpdate User Meta, Delete User Meta, Get User Metadata, Add Role to User, Change User Role, Remove User Role, Create Role
TaxonomyCreate, Update and Delete Category; Create, Update and Delete Tag; Create, Update and Delete Term; Get Taxonomy by Name
Options and pluginsGet Option, Update Option, Check Plugin Active, Activate Plugin
PrivacyGDPR Request Export Personal Data, GDPR Request Erase Personal Data, GDPR Execute Export Personal Data, GDPR Execute Erase Personal Data

Two related actions live in the FlowMattic Tools app: Generate Magic Login Link for passwordless sign-in links and Redirect to URL.

Any hook with Plugin Actions

When a plugin fires its own action hook, enter its name in Plugin or WP Action Hook Name. FlowMattic listens to that hook and passes along its arguments. With several arguments they arrive as arg-0, arg-1 and so on, with nested values flattened into keys such as arg-0_ID, the same shape in your captured sample as in a live run. Each workflow listens to one hook.

Key options

OptionWhereWhat it does
Run WhenNew Post“A new post is published”, “A new post is saved as a draft”, or “Either (once when drafted, again when published)”.
Post TypeNew PostSlugs such as post or product, comma-separated. Empty means any post type except pages.
Post Type, Post StatusUpdate PostRun only for these types and statuses, for example publish, future. Empty means any, drafts included.
Page / Post ID, Post TypeUser Visits a Page/PostLimit the trigger to one item or one post type. Empty means any singular view.
Profile Field, Post Meta FieldField-updated triggersThe single user or post meta key to watch.
User Role, Changed From, Changed ToRole triggersFire only for the role, or the exact role change, you name.
If Nothing Is FoundLookup actions“Stop the workflow with an error” or “Continue the workflow” with found = no.
Post Trigger LinksSettings → GeneralAdds Trigger New Post and Trigger Update Post links to published posts in the posts list. Enabled by default.
FlowMattic builder showing the WordPress Get User by Email action with the If Nothing Is Found option set to Continue the workflow.
Get User by Email with If Nothing Is Found set to continue, so the run carries on with found = no.

Use cases

Announce every published post

When a post goes live, an AI Agent writes a short social version from the title and excerpt, Telegram sends it to the team, and Google Sheets adds it to the content calendar.

New Post (published) → AI Agent → Telegram → Google Sheets

Ask an editor to review new drafts

Set Run When to drafts and each new draft pings the editors’ channel once, with the author and an edit link. Autosaves and later draft saves stay quiet.

New Post (saved as a draft) → Slack

Welcome new users with a one-click sign-in

A membership site greets each new user with a designed email that carries a magic login link, so the first visit needs no password.

New User → Generate Magic Login Link → Send Template Email

Moderate comments with AI

An AI Agent scores each new comment. A Router approves the clean ones with Update Comment, sends doubtful ones to a person, and deletes obvious spam.

New Comment → AI Agent → Router → Update Comment · Slack · Delete Comment

Keep a change log for every client site

Agencies want to know who changed what. Plugin Updated runs once per plugin with the version and the user, and together with Theme Switched and WordPress Core Updated it fills a WP Tables log and a Slack channel.

Plugin Updated · Theme Switched · WordPress Core Updated → WP Tables → Slack

Tag customers when their role changes

When a subscriber becomes a customer, User Role Changed From Specific to Defined fires for exactly that move, and the CRM gets the new tag.

User Role Changed From Specific to Defined → FluentCRM: add tag

Create or update a user from outside data

A SaaS app posts sign-ups to a webhook. Get User by Email, set to continue when nothing is found, feeds a Branch: new emails get a user, known ones get updated meta.

Webhook → Get User by Email → Branch → New User · Update User Meta

Handle privacy requests on time

When a person confirms an erasure request, the workflow notifies the data owner and logs the request, so it is never left in the queue.

GDPR Erase Data Request Confirmed → Email → WP Tables

Tips and gotchas

  • Drafts fire once. New Post on drafts runs when a post is first saved as a draft; editor autosaves and later draft saves never fire it. With “Either”, check post_status in the data to tell the two runs apart.
  • Update Post ignores autosaves. Add publish in Post Status if you only care about changes to live posts.
  • Page views add up. User Visits a Page/Post runs on front-end views of single posts and pages, so set a Page / Post ID or Post Type to keep the run count sensible.
  • Custom post types are welcome. Post type pickers also list types that are managed in wp-admin but never shown on the front end, such as WooCommerce orders.
  • Lookups don’t have to fail. Set If Nothing Is Found to continue, then branch on found.
  • Re-run a post on demand. The Trigger New Post and Trigger Update Post links in the posts list send a published post through again. Turn them off in Settings → General → Post Trigger Links.
  • Plugin Actions workflows are built by hand. Workflow generation with AI does not create them, because the hook name can’t be filled in automatically.

Related features

For an overview of what a site can do on its own events, see WordPress automation.

FAQ

How do I run a workflow when a post is published in WordPress?

Add the WordPress app as the trigger, choose New Post and set Run When to “A new post is published”. Limit it to the post types you want, capture a test post, and map its fields into the next steps.

Can FlowMattic start a workflow from a custom hook?

Yes. The Plugin Actions app listens to any action hook you name, from WordPress core or another plugin, and passes its arguments into the workflow as fields.

Does it work with custom post types?

Yes. New Post and Update Post take one or more post type slugs, and the post actions let you pick any registered type, including ones that only appear in wp-admin.

Will autosaves trigger my workflow?

No. Neither New Post nor Update Post fires on an editor autosave, and a draft starts New Post only once, when it is first saved.

Does WordPress automation work on multisite?

Yes. Network sites can also use the separate WordPress Multisite app, whose triggers include Site Created, Site Deleted, Site Updated and Site Activated.

Let your site react to itself. Try FlowMattic and build your first WordPress workflow on a live demo site.

More from the blog