How automations work
A trigger starts a run, and the steps below it play out in order. Here is how to build one, what each step type does, and how to read the run log.
Lead automations live at Leads → Automations, and appointment automations at Appointments → Automations. Automations on a deal's date, and ones started from inside a workspace such as review follow-ups, are at Workspaces → Automations. Only company owners and admins can manage them.
Every automation is one trigger plus a chain of steps.
Creating one
- Go to Leads → Automations for a lead automation, or Appointments → Automations for an appointment one.
- Click New automation.
- Give it a Name. Only you and your team see this: Website enquiry auto-reply is the kind of name that helps later.
- Pick the Trigger.
- Click Create and add steps.
The trigger cannot be changed later. If you picked the wrong one, create a new automation instead.
Nothing sends until you switch the automation on with the toggle on its row. Automations you start by hand (Started from a lead, Started from a workspace and Started from a contact) have no toggle: they only ever run when someone on your team starts them.
Every contact, lead and workspace also has an Automations tab: start the ones run by hand, stop one part way through, or turn an automatic one off for just that record. See The Automations tab on a contact, lead or workspace.
The triggers you can choose
| Trigger | When it fires |
|---|---|
| New lead | The moment a lead arrives. |
| Lead follow-up | When a lead's scheduled follow-up message falls due. You schedule that on the lead itself. |
| Appointment booked online | When someone books through your appointment link, once per appointment. Appointments your team creates by hand do not fire it. |
| Lead moves to a stage | When a lead lands in a stage you choose on the Leads board. |
| Started from a lead | Only when you start it yourself, from Run automation on a lead. |
| Started from a workspace | Only when you start it yourself, from Workspace actions on a workspace. Set up in Workspaces, on the Automations tab. See Automations you start from a workspace. |
| Started from a contact | Only when you start it yourself, from Actions → Run automation on a contact. Set up in Contacts, on the Automations tab. See Automations you start from a contact. |
| Birthday text | On a contact's birthday, at the time you choose. Set up in Contacts, on the Automations tab. See Birthday texts. |
| On a contact's date | A set time before or after a contact's settlement, fixed rate expiry, interest-only expiry or loan end. Set up in Contacts, on the Automations tab. See Automations on a contact's date. |
| From a deal's date | A set time before or after one of a deal's key dates, such as settlement or the finance clause, for the deals in one stage or a whole pipeline. Set up in Workspaces, on the Automations tab. See Automations on a deal's date. |
| Time in a stage | Once a deal has been in a stage, or a pipeline, for a set time. Set up in Workspaces, on the Automations tab. |
There is no separate "before the meeting" trigger. To remind someone ahead of time you use Appointment booked online and add a Wait step that counts back from the appointment start.
Lead moves to a stage
Pick one or more stages under When a lead moves to. Custom stages you have added to the board are listed alongside the built-in ones. The automation fires the moment a lead lands in any of them, whether you dragged the card, changed the stage on the lead's page, or Marketli moved it (a reply moving a lead to Needs Attention). A lead that arrives already in one of the stages counts too, once: an appointment booked online creates its lead straight in Appointment Booked, so a "moves to Appointment Booked" automation runs for it, as well as any New lead automations. Only leads that arrive after this change run it; earlier bookings are not messaged. It never applies to New (every lead starts there), or when you set Only when it comes from, because a new lead did not come from any stage.
Watch for double messages. Online bookings already get a confirmation and reminders from your appointment automations. If a "moves to Appointment Booked" automation also sends them a message, they will get both. The automation editor warns you about this; either remove one of the messages, or set Only when it comes from so the stage automation runs only for leads your team moves. A cancelled booking does not stop a stage automation that is already running: its waiting steps still send unless you move the lead to another stage, mark it lost, or it replies.
Two optional filters narrow it down: Only when it comes from limits it to moves out of particular stages, and Lead source limits it to leads from particular sources.
By default each lead triggers the automation once, no matter how many times it passes through the stage. Turn on Repeat when the lead re-enters if it should run every time.
A lead who replies by text has any queued steps stopped, and marking a lead Converted or Lost cancels whatever is still waiting. The Leads board shows a small lightning count on a column when automations fire for leads moved into it.
Started from a lead
This one never runs on its own, so it has no on or off switch. Open a lead and choose Run automation; every automation of this kind that has at least one step is listed there. The first step runs straight away and the page tells you what happened, including why a step was skipped. The Automations card on the lead's Details tab shows what is running now and what is due next. The lead's Automations tab lists every lead automation with its switch for this lead, and Run history shows every automation run for that lead, what each has sent and what comes next.
Lead automations can send an email, a text or a push notification, and wait between steps. Tasks, review requests and reward points are for appointment and workspace automations only.
You may also see automations with triggers you cannot pick yourself: Review follow-up and the legacy Upcoming appointment. These come pre-built or are started by a person rather than by a sweep.
The steps
Click the + between steps and choose from Add a step:
| Step | What it does |
|---|---|
| Sends an email. Pick one of your email templates. You can override its subject. | |
| SMS | Sends a text. Pick one of your text templates, and which of your numbers it comes from. |
| Push notification | Pushes to the app. Choose the audience: the client, or named staff. |
| Wait | Pauses the chain. Either for a duration, until a set time before the appointment starts on appointment automations, or until a day counted from the date on an automation on a contact's or a deal's date. |
| Task | Adds a task about the contact for a teammate, or on the deal for its owner, a teammate, a role on the deal or the client. On automations on a contact's or a deal's date, and on the workspace an automation was started from. |
| Move stage | Moves the deal to another stage of the same pipeline. On automations on a deal's date. |
| Award points | Adds reward points. Only offered on appointment and workspace automations, because a lead has no client to award to. Needs a non-zero point amount and a client-facing reason. |
Steps run top to bottom. Click a step to open its editor, fill it in, and Save.
Messages are written as templates, not in the automation. An email or text step attaches one of the templates from the same section: Leads → Templates for a lead automation, Appointments → Templates for an appointment one, Workspaces → Templates for a workspace one, Contacts → Templates for a contact one. Write the message there first, then attach it here. Editing the template changes every automation that uses it, and there is one place to look when the wording is wrong.
Merge fields work inside the templates. See SMS and email templates for the list.
Turning it on
Each row on the Automations tab has a switch, except automations you start by hand, which have none. Flip it on and the automation is live from that moment. It does not go back and act on older leads or appointments.
A birthday text, or an automation on a contact's or a deal's date, first shows who it would reach (who is due today, this week and on the busiest day, and how its texts sit against your daily limit) and asks whether to start from now on or also catch up the contacts whose day has already passed. Switching one of these on from the builder's Save shows the same thing. Automations are checked about every 5 minutes, so catching up starts within about 5 minutes of switching on, between 9 am and 8 pm business time; switched on outside those hours, it starts at 9 am. Deals moved by an automation show on the board once you refresh it. Switching an automation on a contact's date off pauses anyone part way through; switching it back on carries on from where they stopped.
The row also shows a one-line summary of what it will do (the trigger, then the chain) so you can sanity-check it without opening the canvas. Delete an automation with the bin icon. Deleting it stops anything it is still running and deletes its run history.
Reading the run log
Every run is recorded, with a status per step. Most confusion comes from a skipped step, and Marketli explains each one in plain English rather than a code. Common ones:
- Recipient has no email address / Recipient has no phone number
- The sending inbox is disconnected: reconnect it on your Profile.
- No phone number / inbox connected yet
- Recipient has opted out of SMS
- Email address is suppressed (bounced or complained)
- Rate limit reached: too many messages to this recipient or today
- This automation has no steps yet
- Booked too close to the reminder time: the reminder moment had already passed when they booked.
- Automation was created after this appointment's reminder time
- Appointment was cancelled
- Waiting until a time: the step is held for sending hours (8am to 8pm) or your daily text limit, and goes then.
- Paused, on a run: its automation was switched off while the run was waiting.
- The contact's date moved, so this step's day had already passed: nothing is sent late.
- Held back for more than 7 days, so it was not sent
A skip is not a failure. It means the automation ran and correctly decided not to send.
Where to go next
- Appointment confirmations and reminders, including the one you get for free.
- Lead follow-up automations.
Still stuck? Email help@marketli.app.
