Skip to main content

⚡️ Event variables (Transactional Email variables)

Insert personalised data about your patient, their practitioner, appointment details and more

Monique Clark avatar
Written by Monique Clark
Updated today

⚡️ Customise your Peptalkr transactional emails with information specific to the receiving patient, such as their name or the the details of their appointment.

Peptalkr emails require you to use Peptalkr variables if you want to reference Cliniko data specific to the patient who is receiving the email.

If you've ever used Cliniko Placeholders, this is our version of the same thing.

This is really handy if you want to personalise the content of the email, or send important information about their appointment such as the date, time and which practitioner they are seeing.

☝️ Important: these variables are for Transactional emails only.

There are different variables for Campaigns & Automated Journeys.

Testing variables

If you want to test the output of your Transactional variables - use this tutorial.


👤 Patient variables

This data comes straight from the patient's profile in Cliniko.

✅ Compatible with ALL trigger types

Cliniko data

Peptalkr Variable

Example

Patient first name

[patientfirstname]

The first name field of the patient, or the preferred name if one is set.

Patient actual first name

[patientactualfirstname]

The first name field of the patient, regardless of preferred name.

Patient email

[patientemail]

The email address of the patient.

Patient street address

[patientaddress]

The Address Line 1 of the patient.

Patient ID

[patientid]

The Cliniko ID of the patient.


📆 Appointment variables

This data comes straight from the patient's appointment in Cliniko that triggers this email.

⚠️ Not compatible with Medical Alert or Invoice triggers

Cliniko data

Peptalkr Variable

Example

Appointment date & time

[appointmentstart]

Friday, 24 May 10:45am

Appointment date & time (with Timezone)

[appointmentstarttimezone]

Friday, 24 May 10:45am (AEST)

Appointment date

[appointmentstartdate]

Friday, 24 May

Appointment time

[appointmentstarttime]

10:45am

🆕 Appointment year

[appointmentstartyear]

2026

Appointment type

[appointmenttype]

Initial Consultation

Appointment category

[appointmentcategory]

Chiropractic

Appointment ID

[appId]

The Cliniko ID of the appointment.

Appointment cancellation link

 [cancellationlink]

The Cliniko cancellation link for this appointment (only works if cancellations are enabled)

Telehealth meeting link

 [telehealthlink]

The Cliniko telehealth meeting link (only works with telehealth-enabled appointments)


🩺 Practitioner variables

This data comes from your Practitioner users in Cliniko. It will be specific to the Practitioner assigned to the appointment that triggers the email.

⚠️ Not compatible with Medical Alert or Invoice triggers

Cliniko data

Peptalkr Variable

Example

Practitioner full name

[practitioner]

First and last name per their Cliniko user

Practitioner first name

[practitionerfirstname]

First name only

Practitioner email address

[practitioneremail]

Their Cliniko user email addresss

💡 Sending an email from a practitioner

You can configure your Transactional emails to be sent from the treating practitioner by using variables in your email sender details fields. Watch the video.

Email sender name:

[practitioner, fallback=Your Business Name]

You must replace the fallback of "Your Business Name" with your actual business name! This ensures if a Practitioner is made inactive in Cliniko, emails will fallback to being sent by the business.

Email sending address:

[practitioner, fallback=reception]

You must replace the fallback of "reception" with your actual email address before the @ symbol (e.g. info or admin). This ensures if a Practitioner is made inactive in Cliniko, emails will fallback to being sent by your main email.


💡 Forwarding replies to a practitioner

If you want replies to be sent to an email address other than the sending email (e.g. the practitioner) you can use a variable. Refer to this tutorial.


📍 Business variables

This data comes from your business data in Cliniko. It will be specific to the business connected to the appointment that triggers the email.

⚠️ Not compatible with Medical Alert or Invoice triggers

Cliniko data

Peptalkr Variable

Example

Business name

[business]

The business name from your Cliniko business settings

Business display name

[businessdisplayname]

The business display name from your Cliniko business settings

Business suburb / city

[businesscity]

The suburb/city from your Cliniko business settings

Business address

[businessaddress]

The full address from your Cliniko business settings

Business reply email

[businessreplyemail]

The email reply to from your Cliniko business settings

Business contact info

[businesscontactinfo]

The contact information from your Cliniko business settings

Account default reception email

[receptionemail]

The reception email you set on your Peptalkr settings page

👉 Please ensure you check your Cliniko Business Information settings and complete all fields or the above variables may not work as expected.


☑️ Forms

This data comes from your Peptalkr forms.

✅ Compatible with ALL trigger types

Account data

Peptalkr Variable

Example

Peptalkr intake form

[primarynpform]

The link to your primary intake form on the forms tab of your Peptalkr account

Peptalkr feedback form

[feedbackform]

The link to your primary feedback form on the forms tab of your Peptalkr account

If you have multiple intake forms or feedback forms you needn't use these variables. Instead, go to the Forms tab of your account and press the Copy Link button next to the form you want to insert into your email.


🖇️ Booking links & unsubscribe

This data comes from your Peptalkr settings.

✅ Compatible with ALL trigger types

Account data

Peptalkr Variable

Example

Online booking link

[bookinglink]

The online booking link you set on your Peptalkr settings page

Unsubscribe link

 [emailunsubscribe]

🚨 You must include an unsubscribe link at the bottom of your email if you have set the Trigger connected to this email to 'marketing'


FAQs

Can I insert a patient's full name or last name?

No. Peptalkr takes privacy and security seriously. Under guidance of Cliniko themselves, we chose to remove patient last names from our databases - ensuring your patient identities are safer.

We also do not store the patient's year of birth for the same reason.


How can I test that the variables work?

You can test variables by following this tutorial.


Why are some variables not compatible with some triggers?

Variables are data that is tied to the event that caused the trigger to fire. As such, if you are using a Medical Alert or Invoice trigger - these events are not tied to a specific appointment (due to the way Cliniko was designed).

So you won't be able to include Appointment Details in a Medical Alert-triggered email - because the Medical Alert has no tie to a specific appointment.


A variable isn't working

Check the spelling of your variable. Also check if you have applied formatting such as bold, colour, underline - formatting variable can break them if you have not applied the formatting to the entire variable including the brackets.

Also check that you are using the correct variable per the type of email you are sending. Marketing Campaigns and Automated Journeys have their own set of variables different to the Transactional (event) variables.

Did this answer your question?