github Notifuse/notifuse v20.0

latest releases: v28.4, latest, v28.3...
3 months ago

Notifuse v20.0 Release Notes

Release Date: December 22, 2025

Marketing Automations

Version 20 introduces a powerful marketing automation system, enabling you to build automated contact journeys that respond to user behavior in real-time.

automation

What's New

Visual Workflow Builder

Design sophisticated automation workflows with an intuitive drag-and-drop canvas:

  • Node positioning with visual connections between steps
  • Type-specific configuration panels for each node
  • Real-time validation to catch errors before activation

Event-Driven Triggers

Automations start based on contact timeline events:

  • Contact events: Created, updated (with field-specific triggers)
  • List events: Subscribed, unsubscribed, confirmed
  • Segment events: Joined, left
  • Email events: Sent, opened, clicked, bounced, complained
  • Custom events: Any event you track via the API

Configure trigger frequency as once (first occurrence only) or every_time for repeat enrollments.

Automation Nodes

Build complex workflows with 9 node types:

Node Description
Trigger Entry point based on timeline events with configurable conditions
Delay Pause workflow for minutes, hours, or days
Email Send templated emails with full tracking
Branch Conditional branching with multiple paths based on segment conditions
Filter Pass/fail routing based on contact attributes
Add to List Subscribe contacts to additional lists
Remove from List Unsubscribe contacts from lists
A/B Test Deterministic variant selection using FNV-32a hashing
Webhook POST contact data to external URLs with authorization headers

Lifecycle Management

Control your automations with clear state transitions:

  • Draft: Build and test your workflow
  • Active: Go live and start enrolling contacts (creates PostgreSQL triggers)
  • Paused: Stop new enrollments while in-progress journeys continue
  • Deleted: Soft-delete with recovery capability

Contact Journey Tracking

Full visibility into each contact's path through your automations:

  • Complete audit trail with timestamps and execution duration
  • Contact status tracking: active, completed, exited, failed
  • Exit reasons for debugging failed or exited journeys
  • Node execution output logging

API Reference

New endpoints under /api/automations.*:

Endpoint Description
automations.create Create a new automation
automations.get Get automation details
automations.list List all automations
automations.update Update automation configuration
automations.delete Soft-delete an automation
automations.activate Activate a draft automation
automations.pause Pause an active automation
automations.nodeExecutions Get contact journey audit trail

Database Schema Changes

Migration v20.0 adds 4 new workspace tables:

Table Purpose
automations Workflow definitions with trigger config, nodes, and statistics
contact_automations Tracks each contact's journey through automations
automation_node_executions Audit log of node executions for debugging
automation_trigger_log Trigger event logging

Upgrade Instructions

  1. Stop the Notifuse server
  2. Pull the latest version: docker pull notifuse/notifuse:v20
  3. Start the server - migrations run automatically
  4. Verify the upgrade by checking the version in Settings

The migration is non-destructive and creates new tables without modifying existing data.


Getting Started

  1. Navigate to Automations in your workspace
  2. Click Create Automation
  3. Configure your trigger event
  4. Add nodes to build your workflow
  5. Save as draft and test
  6. Activate when ready

Don't miss a new notifuse release

NewReleases is sending notifications on new releases.