Trigger Workflows When WordPress Inserts a Post

Learn how the wp_insert_post trigger starts a workflow and how to filter supported content types and map the normalized post data.

The When WordPress Inserts a Post trigger is available in the WordPress Post group in the AI Agent Workflows editor. It starts a workflow when WordPress fires the wp_insert_post hook.

Screenshot to add: [Workflow editor showing the wp_insert_post trigger and its configuration]

When this trigger fires

This trigger listens to wp_insert_post. Several post-related hooks can fire during one editing or publishing operation, so choose the lifecycle point that best matches your automation.

Data available to later nodes

For recognized post hooks, the plugin can provide normalized values such as source, event, post_id, post_title, post_content, post_content_text, post_excerpt, post_status, post_type, post_name, post_author, post_date, post_modified, and post_parent when post data is available. Inspect a captured sample before relying on a specific field.

Configure the trigger

  1. Open the workflow in the visual editor and open the node picker.
  2. Select WordPress, then Post, and add the trigger.
  3. If the node exposes Post Types, leave it empty for supported posts, pages, and custom post types, or enter comma-separated slugs such as post,page. Internal WordPress content types are skipped.
  4. Save and test with non-critical content, then inspect the sample before mapping values into later nodes.

Source hook

Catalog hook: wp_insert_post. This guide is based on the supplied plugin source and does not claim a live event has been tested.