Skip to navigation

Build Your First Workflow

View as Markdown

In this tutorial you will build a small but genuinely useful workflow: when a new lead arrives, it texts them a friendly welcome and saves them to your contacts. It uses four steps, Start, Send SMS, Add Contact, and End, and takes just a few minutes.

By the end you will know how to add steps, configure them, connect them in order, and save your work. If you have not yet, skim How Workflows Run first so the canvas feels familiar.

What you will build

A lead named Sarah Chen reaches out to Chen Insurance Group. Your workflow will:

  1. Begin when a new lead comes in, capturing their name and phone number.
  2. Text them a warm welcome so they hear from you right away.
  3. Add them to your contacts so an agent can follow up.
  4. Finish.

The finished workflow on the builder canvas: Start, Send SMS, Add Contact, and End connected in order.

Build it step by step

1

Create a new workflow

Open Workflows, click New workflow, choose Build from scratch, then click Start building. Give the workflow a clear name like Lead Welcome and a short description in the builder header so your team knows what it does. Add a Start node from the step picker if the canvas is empty.

2

Define the lead details

Open the Start node, turn on Input Schema, and click Edit Schema. Expand Import from Example and paste:

{
"first_name": "Sarah",
"last_name": "Chen",
"phone_number": "+12025550123",
"business_name": "Chen Insurance Group"
}

Click Generate Schema, then Apply Changes. The imported fields are required. This defines the fields each run accepts; it does not store these example values as the run’s input. When you test, enter your own phone number and test contact details in the run’s input dialog.

3

Add the Send SMS step

Open the step picker, find Send SMS, and add it to the canvas below the Start step. Connect Start to Send SMS so the Start inputs become available in the SMS settings.

The Add a new step picker, listing the steps you can add to a workflow.

4

Configure the welcome text

Select the Send SMS step to open its settings. Fill in two fields:

FieldWhat to enter
ToThe lead’s phone number. Point this at the phone number the Start step captured, so every run texts the right person.
MessageYour welcome text, for example: Hi Sarah, thanks for reaching out to Chen Insurance Group! An agent will call you shortly.

The Send SMS settings panel with a recipient phone number and a welcome message.

To reuse the lead’s real details instead of typing a fixed value, point a field at a value from an earlier step. The builder offers a picker so you can choose it from a list. See Variables & Data Flow.

5

Add the Add Contact step

Open the step picker again, find Add Contact, and add it below Send SMS. Connect Send SMS to Add Contact so this step can also use the Start inputs.

6

Configure the contact details

Select the Add Contact step to open its settings, then fill in the lead’s details:

FieldWhat to enter
First nameThe lead’s first name, for example Sarah.
Last nameThe lead’s last name, for example Chen.
Phone numbersThe lead’s phone number. At least one is required.
Business nameThe lead’s business, for example Chen Insurance Group.

As with the message, you can point these fields at values the Start step captured so each run saves the correct lead.

The Add Contact settings panel with first name, last name, phone number, and business name.

7

Finish the connections

Add an End step from the picker. Connect Add Contact to End and check that the complete path is Start to Send SMS to Add Contact to End. The lines between the nodes are what set the order the steps run in.

8

Save your workflow

The builder saves your changes automatically as a draft. Click Run to test the current workflow, then Publish when you are ready to use it. See Saving & Publishing for running the published version and discarding draft changes.

Try it out

Before you rely on a workflow, it is worth watching it run once. You can step through a run and see exactly what each step did, which makes it easy to spot a field you still need to fill in. See Testing & Debugging.

A run does real work. When your workflow runs, the Send SMS step sends a real text message and the Add Contact step really saves a contact. Use your own phone number and test details while you are trying things out.

Where to go next

You just built a working workflow. From here you can make it smarter: add a step that makes a decision, enroll the new contact in a campaign, or connect another tool your agency uses.