SMS Template Parameters

Last updated: September 18, 2025

This document outlines all the allowed parameters for each SMS template in the Junction platform. These parameters can be used to customize messages sent to patients during different stages of their lab test orders and appointments.

Order Status Templates

Test Kit Orders

TESTKIT_ORDERED

Available Parameters:

  • receiver_name - Name of the person receiving the test kit

  • team_name - Name of the organization/team

Default Message:

“Hey {receiver_name}, Your order for the {team_name} health kit has been placed! We’ll update you with where it is in the process via messages :)”

TESTKIT_TRANSIT_CUSTOMER

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • outbound_tracking_link - Link to track the shipment

  • eta - Estimated time of arrival

Default Message:

“Your order for the {team_name} test kit is in transit, and should be arriving by {eta}.”

TESTKIT_OUT_FOR_DELIVERY

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Your order for the {team_name} test kit is out for delivery, and should be arriving by today”

TESTKIT_DELIVERED_TO_LAB

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Your test kit has arrived to our labs we’re processing your sample now!”

TESTKIT_COMPLETED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“The lab has finished processing your test kit, your results should be ready soon :)”

TESTKIT_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Hey, your order for the {team_name} test kit has been cancelled, If this is by accident please contact support.”

Walk-in Orders

WALK_IN_TEST_ORDERED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Hi, {patient_first_name}, your order for the {team_name} walk-in-test has been placed! We’ll provide you with updates on the status of your order via text messages :)”

WALK_IN_TEST_REQUISITION_CREATED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Hey {patient_first_name}, it’s time to visit your local {lab_name} center. Please check the email you just received for instructions.”

WALK_IN_TEST_REDRAW_AVAILABLE

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Hi {patient_first_name}, your {team_name} results have come back with at least one missing biomarker. We recommend a redraw to complete your lab testing. We will send you an email shortly with more information.”

WALK_IN_TEST_COMPLETED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Your results have finished processing, your results should be ready soon.”

WALK_IN_TEST_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Hey, your order for the {team_name} walk-in-test has be cancelled. If this is by accident please contact support.”

WALK_IN_TEST_APPOINTMENT_SCHEDULED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • date - Appointment date and time

  • booking_link - Link to manage the appointment

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your appointment with the lab has been booked at {date} over at {address}! Here’s your appointment key: {appointment_key}.”

WALK_IN_TEST_APPOINTMENT_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • date - Appointment date and time

  • booking_link - Link to manage the appointment

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Hey, your lab appointment at {date} for {team_name} has been cancelled.”

At-Home Phlebotomy Orders

AT_HOME_PHLEBOTOMY_ORDERED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Hi, {patient_first_name}, your order for the {team_name} at-home phlebotomy service has been placed! We’ll provide you with updates on the status of your order via text messages :)”

AT_HOME_PHLEBOTOMY_REQUISITION_CREATED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to book an appointment

Default Message:

“Hey {patient_first_name}, it’s time to book your at-home phlebotomy draw. Please book a slot using the link provided in the e-mail you just received.”

AT_HOME_PHLEBOTOMY_APPOINTMENT_PENDING

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your appointment with the phlebotomist has been requested! The assigned Phlebotomist should contact you in the next few days via e-mail or phone.”

AT_HOME_PHLEBOTOMY_APPOINTMENT_SCHEDULED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your appointment with the phlebotomist has been booked at {date}! You can reschedule or cancel using the following link {booking_link}.”

AT_HOME_PHLEBOTOMY_APPOINTMENT_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Hey, your at-home-phlebotomy appointment at {date} for the {team_name} has been cancelled. You can rebook using the following link {booking_link}.”

AT_HOME_PHLEBOTOMY_SUCCESSFUL_DRAW

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your at-home phlebotomy draw is complete! We’re delivering your sample to the lab for processing.”

AT_HOME_PHLEBOTOMY_COMPLETED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“The lab has finished processing your blood sample, your results should be ready soon :)”

AT_HOME_PHLEBOTOMY_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Hey, your order for the {team_name} at-home-phlebotomy appointment has be cancelled. If this is by accident please contact support.”

On-Site Collection Orders

ON_SITE_COLLECTION_ORDERED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Hi {patient_first_name}, your lab test with {team_name} has been ordered. Updates will be sent here. If you need help, please ask your on-site provider as this is a no-reply phone number.”

ON_SITE_COLLECTION_REQUISITION_CREATED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Your lab order form is ready! Please check your email for the PDF and follow your provider’s instructions for sample collection. You will receive follow-up communications when results are ready.”

ON_SITE_COLLECTION_DRAW_COMPLETED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Your on-site collection is complete! We’re delivering your sample to the lab for processing.”

ON_SITE_COLLECTION_COMPLETED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Your results have finished processing and should be ready soon.”

ON_SITE_COLLECTION_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • lab_name - Name of the laboratory

Default Message:

“Hey, your order for the {team_name} on-site collection has been cancelled. If this is by accident, please contact support.”

Appointment Templates

Phlebotomy Appointments

PHLEBOTOMY_APPOINTMENT_PENDING

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

Default Message:

“Your appointment with the phlebotomist has been requested! The assigned Phlebotomist should contact you in the next few days via e-mail or phone.”

PHLEBOTOMY_APPOINTMENT_CONFIRMED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your appointment with the phlebotomist has been booked at {date}! You can reschedule or cancel using the following link {booking_link}.”

PHLEBOTOMY_APPOINTMENT_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Hey, your at-home-phlebotomy appointment at {date} for the {team_name} has been cancelled. You can rebook using the following link {booking_link}.”

Patient Service Center Appointments

PATIENT_SERVICE_CENTER_APPOINTMENT_CONFIRMED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Your appointment with the lab has been booked at {date} over at {address}! Here’s your appointment key: {appointment_key}.”

PATIENT_SERVICE_CENTER_APPOINTMENT_CANCELLED

Available Parameters:

  • patient_first_name - Patient’s first name

  • team_name - Name of the organization/team

  • booking_link - Link to manage the appointment

  • date - Appointment date and time

  • appointment_time - Time of the appointment

  • appointment_date - Date of the appointment

  • address - Address of the appointment location

  • appointment_key - Unique identifier for the appointment

Default Message:

“Hey, your lab appointment at {date} for {team_name} has been cancelled.”

Parameter Descriptions

Parameter

Description

Example Value

patient_first_name

The first name of the patient

“John”

receiver_name

Name of the person receiving communications

“John Smith”

team_name

Name of the organization/team providing the service

“Acme Health”

lab_name

Name of the laboratory processing the samples

“LabCorp”

date

Formatted appointment date and time

“2:00 PM - 3:00 PM on Monday, September 18”

appointment_date

Specific date of the appointment

“Monday, September 18”

appointment_time

Specific time slot of the appointment

“2:00 PM - 3:00 PM EST”

address

Full formatted address of the appointment location

“123 Main St, San Francisco, CA 94102”

appointment_key

Unique identifier for the appointment

“ABC123”

booking_link

URL link to manage/reschedule appointments

https://example.com/appointments/manage/abc123

outbound_tracking_link

URL link to track shipment delivery

https://tracking.fedex.com/123456

eta

Estimated time of arrival for deliveries

“Wednesday, September 20”

Usage Notes

  1. Parameter Validation: All parameters are validated when templates are processed. Using undefined parameters will result in an error or an unsent message.

  2. Optional Parameters: Some parameters may be optional depending on the context. If a parameter is not provided, it should not be included in the template.

  3. Parameter Formatting: Date and time parameters are automatically formatted based on the appointment’s timezone when available.

  4. Null Values: Parameters with null values are automatically filtered out during template processing.

Last updated: September 18, 2025