How-To: Registration & Trial Flow Setup Detailed

You are here:
< All Topics
Table of Contents

How to use email drip sequence in free trials and onboarding?

A detailed blog post can be found here.

Below are complete how-to implement details including marketing automation usage and API calls.


  1. Registration Form in Saturn Funnels
  2. The form can include a drip sequence trigger
  3. Use the “Trial Sign-Up, But Not Initiated” email drip sequence template to start
  4. Form Completion, Data to Your SaaS App
  5. Via an URL with parameters of the form
  6. visitorId parameter is included to link with Saturn Funnels
  7. Setup Trail & Onboarding Automation Email Sequences
  8. Create the desired drip sequences (we have templates starters)
  9. Create the automation for “Trial Initiated”
  10. Complete Registration in Your SaaS App
  11. Use the visitorId to get a contact_id
  12. Send trial/onboarding start time and/or customer start time
  13. Add Trail Milestone Automation
  14. Add triggers for Milestone Added
  15. Add triggers for Milestones Not Added in X days
  16. Program hooks within your SaaS to send milestone Events to Saturn Funnels API

1. Registration Form in Saturn Funnels

All Calls-To-Actions (CTAs), Popups and Landing Pages can have a form. This is the way you can capture the initial information in your registration (e.g. email and a plan).

Some helpful links:

However you chose to deploy your registration form, we suggest you include:

  • Email address
  • An automation sequence
  • A plan that they will subscribe to…assuming you have more than one

To and a drip email sequence:

  1. Drag-n-Drop the “add to email sequence” field from the Form Fields column to the My Form Fields column.
  2. Select it, by clicking it, in the My Form Fields column.
  3. In the right column, you can select the desired sequence.

Then when this form is filled out, that visitor will be added to that drip sequence.

To add the “plan” to the form you have three choices:

  1. Hidden field (see below)
  2. A dropdown select field
  3. Or a radio button group

In the example below, the hidden variable is “plan” and the value is set to “monitor_v1”. This is used on our pricing page to select the Monitoring only plan for trial and churn automation and not marketing automation.

2. Form Completion, Data to Your SaaS App

Next, you need to set a “Destination URL” to send the form data. The CTA, Popup and Landing Page editors have this option (see below for a popup):

  1. Under the “Form Completed” tab select the “Destination URL” option.
  2. Ent in your SaaS app’s registration URL

An example URL might be https://app.mydomain.com/register.

The Saturn Funnels will send the for data as URL encoded parameters. With this example URL and the above form you would get:

You can ignore the “add_sequence” value in your app. Saturn Funnels will add that email and visitor to that sequence. You can remove it in an automation or API call as desired.

The visitorId is important. It is a unique identifier that you can use to identify that visitor within Saturn Funnels via our API. We discuss this below.

3. Setup Trail & Onboarding Automation Email Sequences

Create you drip email sequences. These can and should include:

  • Signed Up, But Not Registered… recommended
  • Times Trial/Onboarding… recommended
  • Feature Activated Sequences…triggered by milestones
  • Feature Activation Encouragement…triggered when a milestone is not completed

 To create drip sequences:

  1. Select Email ➥ Sequences from the sidebar
  2. Create a New sequence with a template or a blank “empty” sequence
  3. The templates include some SaaS specific signup and trial sequences
  4. Edit the sequences. Learn more here.

Note: Do not forget to add the “Trial Sign Up, But Not Initiated” sequence to your forms in step 1.

4. Complete Registration in Your SaaS App

So now you have the URL parameters from step 2.

  • email
  • visitorId
  • plan

The visitorId is important. It is used by Saturn Funnels to record every page visit, every CTA seen, every popup show, every form filled out or button click, and all email actions.

However, that person visits your website via two different devices and fills out form on both devices they will have two different visitorIds. If they use the same email address these will be combined into just one contact.



So, you need to use this visitorId to get the contact_id. And store it in your database for all future communications. Use our API. Below are three different methods you might wish to use to get the contact_id depending on your use case:

  1. Set Trial/Onboarding Dates (link here)
  2. //api.saturnfunnels.com/api/app/contact/trial-onboard-dates
  3. This tells Saturn Funnel they are in a trial within the dates set
  4. These are used for the dashboard and reporting
  5. Also used to trigger a Trial Initiated automation
  6. Returns contact_id
  7. Set As Customer With Dates (link here)
  8. //api.saturnfunnels.com/api//app/contact/set-customer
  9. This tells Saturn Funnel they are in a subscriber now with a start date
  10. These are used for the dashboard and reporting
  11. Also used to trigger an Activation automation and receive retention events
  12. Returns contact_id
  13. Get Contact  (link here)
  14. //api.saturnfunnels.com/api/app/contact/get
  15. Returns the contact record with its _id, the contact_id

5. Add Trail/Onboarding Milestone Automation

When a user is in your free trial or just onboarding you want them to succeed with your SaaS app. Email automation can help increase user engagement and this help with and accelerate their activation (“aha moment”) — convert from trial to a paid account as the major use case.

Saturn Funnels has both trial/onboarding automation and trial/onboarding milestone tracking and analysis features. Here we talk about how to use automations with our API milestone events.

To learn about creating milestones by creating In-App Events.

In step 3 above you learned how to create email sequences. You can use these in automations. In step 4.1 you learn to trigger a “Trial Initiated” automation. Below you will learn to trigger automations based upon milestones. You can:

  • Add automation triggers for Milestone Added
  • Add automation triggers for Milestones Not Added in X days
  • Program hooks within your SaaS to send milestones to Saturn Funnels API

After you have created your email sequences go to the sidebar and select Trials➥Automation to bring up a list of your onboarding automations.

Create Automation:

  1. Name the automation
  2. Select an “Automation Type”:
  3. Trial Initiated
  4. Milestone(s) Added
  5. Timed: Milestones Not Added in X Days
  6. Select the “Plan” the automation applies or “All Plans”
  7. Set up your plans 
  8. Select the “Email Sequence To Trigger” in the dropdown
  9. Click the “Events” that are the triggers
  10. For multiple Events selected, select
    • Logical AND … all have to be set
    • Logical OR … any of the list
  11. Select any sequences to “Remove Contacts From Email Sequence(s) When Triggered”
  12. Removes these sequences if the contact is in them, can be multiple

Send Events to Saturn Funnels

Milestones are In-App Events.

In-App Events API

Add In-App Events to Contact

An endpoint to add In-App Events to a contact.  Use the event_id from the User Interface: In-App Events > Define Event page. 

These events are used for trials/onboarding/churn automations, and various reports in the dashboard.

JSON Endpoint:

post: //api.saturnfunnels.com/api/app/contact/event

JSON Body:


api_key: string, //  found in dashboard

// one of the following 2

contact_id: string, // unique contact identifier,

visitorId: string, // either contact_id or visitorId is required

event_id: string  // required, from the dashboard



contact_id: string, // contact _id

event_id: string,

status: ‘ok’


Table of Contents

How to Choose Marketing Automation Tools For Your SaaS


Everything you need to consider. Including often overlooked SaaS Specific considerations!