Guides

Journeys

A journey is a set of emails that send themselves based on what people do on your site: a welcome series after sign-up, a reminder when a cart is left, a nudge the day before an appointment. Every journey reads as one sentence: when X happens, wait, send, stop if Y. Find them under Automations → Journeys, or ask the AI: “send a welcome email a day after someone signs up”.

What starts a journey

  • An event your site records (see Site events): built-in ones like member_signed_up or payment_succeeded, or your own like cart_abandoned. Add conditions on the event's properties (“only when total is more than 100”).
  • By hand: you, a function or an AI agent puts a person in.
  • A record added to or changed in one of your tables.
  • A date on a record: 24 hours before an appointment, 7 days after a delivery.

Each person enters once, every time, or at most once per cooldown, your choice.

Steps

  • Wait for a duration, or until a time of day.
  • Send email: write it in place with placeholders such as {{name}}, {{email}} and any property of the event ({{total}}), or pick one of the site's saved email templates. Send from the platform sender or from one of your connected sending accounts.
  • If / otherwise: branch on whether they opened or clicked an earlier email, on an event since they entered, or on a property.
  • Update record, call a URL, run a function, stop.

Stop early when conditions are checked before every step, so a cart reminder never goes out after the order is placed.

Sending, tracking and safety

  • Opens and clicks are tracked by default and appear on the journey as email_sent, email_opened and email_clicked events. Turn tracking off per journey or per email.
  • People on the site's unsubscribe list are never emailed; every journey email carries an unsubscribe link.
  • Journey emails count against the site's monthly email quota unless they go through your own sending account.
  • Bounces and spam complaints reported by the mail provider put the address on the suppression list automatically and appear as email_bounced and email_complained events.
  • Live enrols and sends. Paused lets nobody new in while people inside finish. Stopped halts everyone at once.

Starters

Welcome series, abandoned cart, appointment reminder and win-back come ready to edit. Each lists the events it expects your site to record.

For the AI and MCP

The same journeys are available as tools: journeys_templates, journeys_create, journeys_update, journeys_setStatus, journeys_runs, journeys_enrol. The AI checks the site's event catalog first so a trigger names an event the site really records.