MailMoo
ToolsCampaigns

mailmoo_campaign_add_step

Add a step to a campaign's sequence

Adds one step to a campaign's sequence: message, connection_request, connection_request_with_note, inmail, email, wait, profile_visit, move_to_campaign, update_tag (sets tag on the lead), or a condition: is_connected, has_engaged, filter_leads, filter_lead_fit. THE CAMPAIGN MUST BE PAUSED. Get step ids from campaign_get_context or from this tool's result. afterStepId places it; leave it out to append to a sequence with no branches, or pass atStart to put it first. When afterStepId is a condition, pass branch 'yes' or 'no' for the path the step starts. A new condition has a Yes and a No path: the steps that followed the insertion point go on its continueOn path (yes by default) and the other path starts empty, ready for steps with afterStepId = the condition. is_connected needs waitForAcceptanceSeconds: 1814400 (21 days) on the check after a connection request, null on the opening check before one. has_engaged: Yes once they replied (signal replied, channel any, social or email, withinDays) or opened the last message (signal opened); put it before follow-ups so people who replied stop. filter_leads: rules on the campaign's columns (names from campaign_get_context's columns), match all or any; leads that match go down Yes. filter_lead_fit: leadFit on the 0 to 4 Lead Fit score; the campaign must be scored first. sendCondition sets when a message, InMail or email step sends (noReply: skip once they replied; always; noPrevMessages: skip when a conversation exists; notOpened: skip when they opened the last message; noPrevEmails for email), and stopIfSkipped ends the lead's sequence when it is skipped. Waits are in seconds (a day is 86400). move_to_campaign ends the lead's sequence and starts them in targetCampaign from its first step (anything already sent stays sent); it goes at the end of a path, nothing can be added after it, and the target cannot be this campaign or one that moves leads back here. The move happens right away, even when the target is turned off. Personalize with merge fields from campaign_get_context's mergeFields, e.g. {{First Name | ""}}. A message step can go as a voice note (voiceNote): ai speaks the content as a script in a cloned voice, prerecorded sends one recording from the library; list the choices with voice_notes_list and ask the user which, and whose voice, when they have not said. A message can also go as up to three messages in a row (split), whose last one is a message, a voice note or the lead's own video or slide as a file; a single message can carry that file (attachment). The step is checked before it is saved: unknown merge fields, a step a sender cannot perform (InMail needs Premium, an AI voice note needs a voice clone), or a connection note over the length limit are refused with the reason. The result lists the sequence (each step's afterStepId, branch, and condition settings) and readiness: what would still stop the campaign from starting, including a path after a connection request that sends nothing. A connection request only works between two Is connected checks (IS_FIRST_LEVEL_CONN steps): on the No path of one that decides at once, so people already connected skip the request, and followed by one that waits for the acceptance, with the messages on its Yes path. Templates have both.

Effect: Write. See Effects.

Permissions: Read campaigns, Write campaigns.

Parameters

ParameterTypeRequiredDescription
campaignstringYesThe campaign, by name or id.
typemessage, connection_request, connection_request_with_note, inmail, email, wait, profile_visit, move_to_campaign, update_tag, is_connected, has_engaged, filter_leads, filter_lead_fitYes
afterStepIdstringNoInsert after this step.
branchyes, noNoWhen afterStepId is a condition: which path to start.
atStartbooleanNoPut the step first, before the current first step. Instead of afterStepId.
continueOnyes, noNoConditions: the path the steps after the insertion point go on. Defaults to yes.
tagstringNoupdate_tag: the tag set on the lead when it reaches the step, by name or id. Required when adding update_tag.
waitForAcceptanceSecondsinteger or nullNois_connected: how long to wait for a pending connection request to be accepted before deciding, in seconds (21 days is 1814400; 15 minutes to 90 days). Null decides at once. Use a wait on the check after a request, null on the opening check before one. Required when adding is_connected.
withdrawRequestbooleanNois_connected: withdraw the request when the wait runs out without an acceptance. Defaults to on for a check that waits.
signalreplied, openedNohas_engaged: replied (the default) is Yes once the lead has replied; opened is Yes once they opened the last message.
channelany, social, emailNohas_engaged with replied: where a reply counts. Defaults to any.
withinDaysinteger or nullNohas_engaged: only count replies from the last N days (1 to 3650). Null or left out counts any time.
rulesarray of objectNofilter_leads: the rules on the campaign's columns. Leads that match go down Yes, the rest down No. Required when adding filter_leads; on edit it replaces every rule.
matchall, anyNofilter_leads: all (the default) needs every rule to match, any needs one.
leadFitobjectNofilter_lead_fit: one of atLeast, atMost or equals, on the 0 to 4 Lead Fit score. Required when adding filter_lead_fit; the campaign needs a Lead Fit column.
contentstringNoMessage, note, InMail or email text. Required for those.
subjectstringNoInMail or email subject.
waitTimeSecondsintegerNoWait steps: how long, in seconds.
targetCampaignstringNomove_to_campaign steps: the campaign the lead starts next, by name or id. Required when adding one.
sendConditionnoReply, always, noPrevMessages, notOpened, noPrevEmailsNo
stopIfSkippedbooleanNo
emailThreadingreplyToThread, newEmailNoEmail steps: reply in the earlier thread, or a new email.
voiceNoteobjectNoMessage steps only. Ask the user which they want when it is not clear: a written message, an AI voice note (say whose voice: each sender's own clone, or one named clone), or a pre-recorded voice note (say which recording). With prerecorded, content is optional and is sent as text only if the recording cannot be loaded.
splitobject or nullNoMessage steps only: send the message as several messages in a row, which reads more naturally. null sends it as one message again. A voice note step (voiceNote ai or prerecorded) cannot be split: make the last part the voice note instead. A split message cannot have variants: remove them first.
attachmentobjectNoMessage steps sent as one message: a file that goes with it. A split message sends its file as its last part instead (see split).

On this page