Skip to main content

How to Add and Manage Workflow Actions

Learn how to add, edit, or remove workflow actions, including messages, waits, conditions, record updates, and integrations.

Actions are the steps a workflow runs after its trigger, like sending a text, waiting, checking a condition, or tagging a patient. This article shows how to add, change and remove actions, and what to fill in for each one.

You need a workflow with a trigger before you add actions. If you don't have one yet, start with How to Create a Workflow and How to Set Up Workflow Triggers. The examples below use a test workflow that starts when a patient is created and stays turned off.

Add an action

  1. Go to Settings → Data → Workflows and click the workflow's name.

  2. Click the + under the step the new action should follow.

  3. In Add a step, scroll through the groups (Communication, Timing & Logic, Data & Records, Integrations) or type in Search actions....

  4. Click the action. Its settings panel opens.

  5. Fill in the settings (see the sections below), then close the panel.

The new step appears on the canvas. Until its required settings are filled in, the step shows Needs setup.

Opening the demo workflow, clicking the plus under the last step, browsing and searching Add a step, and choosing Manage Patient Tag

Add an action between two steps

  1. Click the + on the line between the two steps.

  2. Choose the action in Add a step and fill in its settings.

  3. Close the panel.

The new step is placed between the two steps, and the steps below it move down.

Clicking the plus between the Trigger and Send SMS steps, adding a 15 minute Delay, and the Delay appearing between them

Change or remove an action

Change an action

  1. Click the step on the canvas to open its settings.

  2. Make your changes. If the panel has a save button at the bottom, such as Save SMS Configuration, click it.

  3. Close the panel.

Remove an action

  1. Point to the step and click the trash can in its top-right corner.

  2. Click OK in the browser message Are you sure you want to delete this node?

When you remove a step from the middle of a workflow, its connecting lines go with it, so the steps below are left unconnected. To reconnect them, drag from the dot at the bottom of the step above to the dot at the top of the step below.

Editing the Send SMS step, deleting it with the trash can, and dragging a new connection from the Trigger to the next step

Set up messages and notifications

Each section below starts with the Add a step list open, as in Add an action above.

In message fields, type { to open the list of merge tags, such as Patient First Name, and click one to insert it.

Send Email

Emails the patient or contact the workflow is running for.

  1. Choose Send Email.

  2. Optionally enter From Email and From Name. Leave From Email blank to use the default sender.

  3. Leave Marketing message off for appointment details and other care emails. Turn it on only for promotional emails: they go only to patients who opted in to marketing email and include an unsubscribe link.

  4. Enter the Subject. It also shows on the step card.

  5. Write the email on the Plain Text tab, or open Designed Email and click Select Email Template.

  6. Click Save Email Configuration, then close the panel.

Adding Send Email, entering a From Name, a subject with the Patient First Name merge tag and a plain text body, and saving

Send SMS

  1. Choose Send SMS.

  2. Type the text in Message (up to 320 characters). The first 50 characters show on the step card.

  3. Check Marketing message. It can already be on when you add the step. Turn it off for appointment reminders and other care messages. Marketing texts only go to patients who opted in to marketing SMS.

  4. Optionally turn on Skip SMS if patient recently texted. The text is skipped if the patient sent a message within the Recent text buffer (hours) (24 hours unless you change it).

  5. Click Save SMS Configuration, then close the panel.

If Respect message quiet times is on in Workflow settings (the default), texts and emails send only from 8:00 AM until before 9:00 PM in the patient’s primary location time zone, or the practice time zone if unavailable; turning it off and saving the workflow allows messages to send at any time.

Adding Send SMS, typing a message with a merge tag, turning off Marketing message, turning on Skip SMS if patient recently texted, and saving

Send Staff Notification

Sends an in-app notification to your team, for example to alert the front desk about a new patient.

  1. Choose Send Staff Notification.

  2. Type the alert in Message. Type { to add patient, task or prescription details.

  3. Under Who gets notified, choose at least one:

    • Specific people: always notified, wherever the event happens.

    • Everyone with a role, such as Front Desk.

    • People on the record: Task owner or Provider on the record.

  4. Turn on Only staff at the event's location to limit role alerts to that location. If the event has no location, role members aren't notified, so add specific people to cover those events.

  5. Close the panel. This step has no save button: changes apply right away.

Adding Send Staff Notification, typing a message with a merge tag, and choosing the Front Desk role

Send Paperwork

  1. Choose Send Paperwork.

  2. Choose one or more Consents, one or more Custom Forms, or both.

  3. Close the panel.

Adding Send Paperwork and choosing a consent and a custom form

Control timing and paths

Delay / Wait

  1. Choose Delay / Wait.

  2. Click a Quick pick, such as 1 day, or enter a Custom wait time and choose Minutes, Hours or Days.

  3. Check the Summary, click Save, then close the panel.

Adding Delay / Wait and setting a custom wait of 3 days

Condition

Checks something before the workflow continues. The workflow follows the Yes path when the condition is true and the No path when it isn't.

  1. Choose Condition.

  2. Describe the condition in plain words, for example Patient has an upcoming appointment.

  3. Click Generate and check that the Condition Summary matches what you meant.

  4. Close the panel. Click the + under Yes or No to add steps to each path.

Adding a Condition, describing it, clicking Generate, and the Yes and No paths on the canvas

Branch

Splits the workflow into one path per value of a field, for example a different path for each lead source.

  1. Choose Branch.

  2. Enter the Field Path, the piece of workflow data to check, written with dots between the parts.

  3. Type each value under Branch Values and click Add branch. Each value gets its own path.

  4. Choose a Match Type: Exact Match or Contains. Use Case Sensitive if capital letters matter.

  5. Check the Preview, click Save Branch Configuration, then close the panel.

Each value shows as a path under the step, plus a NO MATCH path for everything else. Click the + on a path to add its steps.

Adding a Branch on the patient source with Instagram and Google values, and the branch paths on the canvas

Work with records and data

Manage Patient Tag

Adds or removes a tag on the workflow's patient.

  1. Choose Manage Patient Tag.

  2. Click Add Tag or Remove Tag.

  3. Choose the Tag, then close the panel.

Adding Manage Patient Tag, choosing Add Tag, and selecting a tag

Add Coupon

Adds a coupon to the patient's wallet. A text later in the workflow can name the coupon with the merge tag {{addedCoupon.name}}.

  1. Choose Add Coupon.

  2. Choose the Coupon, then close the panel.

Adding Add Coupon and choosing a coupon

Write to Patient Activity Log

Adds an entry to the patient's activity timeline, so your team can see what the workflow did.

  1. Choose Write to Patient Activity Log.

  2. Enter a Heading and a Body. Both can include merge tags.

  3. Close the panel.

Adding Write to Patient Activity Log with a heading and a body that uses a merge tag

Create Prospyr Object

Creates a new Lead, Patient, Appointment, Task or Clinical Note. The example creates a follow-up task.

  1. Choose Create Prospyr Object and pick the Object Type to Create.

  2. Click Add Field Mapping for each detail of the new record:

    • Leave the switch on Field to copy data from the workflow, such as Patient ID.

    • Switch it to Value to type fixed text, such as the task description.

    • On the right, choose the field of the new record to fill.

  3. Close the panel.

Auto-Map Fields fills in mappings for you. Check each one before you save, since it can match fields you didn't intend.

Adding Create Prospyr Object for a Task and mapping a typed description and the Patient ID

Update Prospyr Object

Changes fields on an existing Lead, Patient or Task.

  1. Choose Update Prospyr Object and pick the Object Type to Update.

  2. Under Lookup Configuration, choose the Source Field from the workflow data and the Target Field to match it against, such as Email and Email. The workflow updates the first record that matches.

  3. Under Add a field to update, click a field, then choose Map from trigger data or Set static value and fill it in.

  4. Close the panel.

Adding Update Prospyr Object for a Patient matched by email and setting a static Profile Note

Archive Prospyr Object

Archives records so they no longer appear as active. You can archive Opportunity records.

  1. Choose Archive Prospyr Object and pick Opportunity.

  2. Choose the Source Field and the Target Field to match, such as Patient ID and Patient ID.

  3. Close the panel.

The workflow archives all opportunities that match, not just the first one.

Adding Archive Prospyr Object for Opportunity records matched by Patient ID

Lookup Object

Finds a Patient, Location, Provider or Service so later steps can use its details.

  1. Choose Lookup Object and pick the Object Type to Lookup.

  2. Choose Lookup By Field, such as Location Name.

  3. Leave Value Source on Literal Value to type the value, or switch it to Field Reference to use workflow data. Enter the Lookup Value.

  4. Check the Preview, then close the panel.

The step gets a FOUND and a NOT FOUND path. Click the + on each to choose what happens next. Patient triggers already include the patient's details, so you usually don't need a patient lookup.

Adding Lookup Object for a Location by Location Name with a typed value

Transform with AI

Turns workflow data into new, cleanly labeled fields that later steps can use, for example splitting a full name into first and last name.

  1. Choose Transform with AI.

  2. Under What should this step produce?, describe the result, or click Use full-name example.

  3. Click Set up with AI and review the fields it creates under Review the generated output.

  4. Click Save transform, then close the panel.

Adding Transform with AI, using the full-name example, setting it up with AI, and saving the transform

Send data to other system

HubSpot Action

Sends workflow data to HubSpot. The panel shows HubSpot is connected! when your HubSpot account is linked.

  1. Choose HubSpot Action.

  2. Pick the Action Type: Create Contact, Update Contact, Create Deal or Update Deal.

  3. Click Add Field Mapping, then choose the HubSpot Field and the Prospyr Data that fills it.

  4. Optionally enter a Node Label to give the step a name you'll recognize, then close the panel.

Adding a HubSpot Action to create a contact and mapping the email field

Send Webhook

Sends workflow data to another system's web address.

  1. Choose Send Webhook.

  2. Enter the Webhook URL from the other system and pick the HTTP Method it expects.

  3. Add any Headers the other system needs and choose the Payload Type.

  4. Edit the sample Payload to match what the other system expects. Use double braces for merge tags, for example {{patientWorkspace.firstName}}, or pick one from Insert merge tag at cursor....

  5. Click Save Webhook Configuration, then close the panel.

Adding Send Webhook with a test URL, reviewing the method, headers and sample payload, and saving

Save your changes

Changes to steps show on the canvas right away, but nothing is kept until you save the workflow. Until then, Unsaved changes shows next to the name.

  1. Click Save Workflow.

  2. Prospyr shows Workflow updated successfully!

Saving doesn't turn the workflow on. To turn it on, see How to Create a Workflow.

Clicking Save Workflow, the Workflow updated successfully message, and the workflow still Disabled

Good to know

  • You can save a workflow while a step still shows Needs setup. Open each step and check it before you turn the workflow on.

  • Closing Add a step without choosing an action removes the empty step.

  • Some actions only appear when your practice has the related feature, so your list may look different.

Did this answer your question?