Who This Is For / When to Use
This article is for users building workflows, campaigns, appointment reminders, or message templates who want to personalize content automatically.
Use this when:
You are creating automated emails or SMS messages.
You need to insert contact, appointment, or account details dynamically.
You want messages to adapt based on timing, attribution, or assigned users.
What Custom Values Are
Custom values are placeholders wrapped in double curly braces (for example, {{contact.first_name}}).
When a workflow, campaign, or message runs:
Kyrios replaces the custom value with real data.
No manual editing is required.
Messages remain personalized at scale.
Contact Custom Values
Full Name:
{{contact.name}}First Name:
{{contact.first_name}}Last Name:
{{contact.last_name}}Email:
{{contact.email}}Phone (formatted):
{{contact.phone}}Phone (raw):
{{contact.phone_raw}}Phone (recommended for links):
Tel:{{contact.phone_raw}}Company Name:
{{contact.company_name}}Full Address:
{{contact.full_address}}Address Line 1:
{{contact.address1}}City:
{{contact.city}}State:
{{contact.state}}Postal Code:
{{contact.postal_code}}Time Zone:
{{contact.timezone}}Date of Birth:
{{contact.date_of_birth}}Source:
{{contact.source}}Website:
{{contact.website}}Contact ID:
{{contact.id}}
User Custom Values
Full Name:
{{user.name}}First Name:
{{user.first_name}}Last Name:
{{user.last_name}}Email:
{{user.email}}Phone (formatted):
{{user.phone}}Phone (raw):
{{user.phone_raw}}Email Signature:
{{user.email_signature}}Calendar Link:
{{user.calendar_link}}Appointment Phone (raw):
{{appointment.user.phone_raw}}Twilio Phone:
{{user.twilio_phone_number}}Twilio Phone (raw):
{{user.twilio_phone_number_raw}}
Appointment Custom Values
Title:
{{appointment.title}}Start Date & Time:
{{appointment.start_time}}Start Date Only:
{{appointment.only_start_date}}Start Time Only:
{{appointment.only_start_time}}End Date & Time:
{{appointment.end_time}}End Date Only:
{{appointment.only_end_date}}End Time Only:
{{appointment.only_end_time}}Day of the Week:
{{appointment.day_of_week}}Month Name:
{{appointment.month}}Time Zone:
{{appointment.timezone}}Cancellation Link:
{{appointment.cancellation_link}}Reschedule Link:
{{appointment.reschedule_link}}Meeting Location:
{{appointment.meeting_location}}Notes:
{{appointment.notes}}Add to Google Calendar:
{{appointment.add_to_google_calendar}}Add to iCal / Outlook:
{{appointment.add_to_ical_outlook}}
Recurring Appointments
Repeats:
{{appointment.recurring.repeats}}Times to Repeat:
{{appointment.recurring.times_to_repeat}}
Assigned User (Appointment)
Full Name:
{{appointment.user.name}}First Name:
{{appointment.user.first_name}}Last Name:
{{appointment.user.last_name}}Email:
{{appointment.user.email}}Phone:
{{appointment.user.phone}}Phone (raw):
{{appointment.user.phone_raw}}Email Signature:
{{appointment.user.email_signature}}Twilio Phone:
{{appointment.user.twilio_phone_number}}
Calendar & Campaign Custom Values
Calendar Name:
{{calendar.name}}Campaign Event Date & Time:
{{campaign.event_date_time}}Campaign Event Date:
{{campaign.event_date}}Campaign Event Time:
{{campaign.event_time}}
Message Custom Values
Message Body:
{{message.body}}Message Subject:
{{message.subject}}
Account Custom Values
Account Name:
{{location.name}}Full Address:
{{location.full_address}}Address Line 1:
{{location.address}}City:
{{location.city}}State:
{{location.state}}Country:
{{location.country}}Postal Code:
{{location.postal_code}}Email:
{{location.email}}Phone:
{{location.phone}}Phone (raw):
{{location.phone_raw}}Website:
{{location.website}}Logo URL:
{{location.logo_url}}Owner First Name:
{{location_owner.first_name}}Owner Last Name:
{{location_owner.last_name}}Owner Email:
{{location_owner.email}}Account ID:
{{location.id}}
Right Now (Dynamic Date & Time)
Second:
{{right_now.second}}Minute:
{{right_now.minute}}Hour (24h):
{{right_now.hour}}Hour (AM/PM):
{{right_now.hour_ampm}}AM / PM:
{{right_now.ampm}}Day of Week:
{{right_now.day_of_week}}Day:
{{right_now.day}}Month (number):
{{right_now.month}}Month (name):
{{right_now.month_name}}Month (extended):
{{right_now.month_english}}Year:
{{right_now.year}}Date (MM/DD/YYYY):
{{right_now.middle_endian_date}}Date (DD/MM/YYYY):
{{right_now.little_endian_date}}
Attribution Custom Values
First Attribution
Session Source:
{{contact.attributionSource.sessionSource}}URL:
{{contact.attributionSource.url}}Campaign:
{{contact.attributionSource.campaign}}UTM Source:
{{contact.attributionSource.utmSource}}UTM Medium:
{{contact.attributionSource.utmMedium}}UTM Content:
{{contact.attributionSource.utmContent}}UTM Keyword:
{{contact.attributionSource.utmKeyword}}UTM Match Type:
{{contact.attributionSource.utmMatchType}}Campaign ID:
{{contact.attributionSource.campaignId}}Ad Group ID:
{{contact.attributionSource.adGroupId}}Ad ID:
{{contact.attributionSource.adId}}Facebook Click ID:
{{contact.attributionSource.fbclid}}Google Click ID:
{{contact.attributionSource.gclid}}Referrer:
{{contact.attributionSource.referrer}}
Latest Attribution
Session Source:
{{contact.lastAttributionSource.sessionSource}}URL:
{{contact.lastAttributionSource.url}}Campaign:
{{contact.lastAttributionSource.campaign}}UTM Source:
{{contact.lastAttributionSource.utmSource}}UTM Medium:
{{contact.lastAttributionSource.utmMedium}}UTM Content:
{{contact.lastAttributionSource.utmContent}}UTM Campaign:
{{contact.lastAttributionSource.utmCampaign}}UTM Keyword:
{{contact.lastAttributionSource.utmKeyword}}UTM Match Type:
{{contact.lastAttributionSource.utmMatchType}}Campaign ID:
{{contact.lastAttributionSource.campaignId}}Ad Group ID:
{{contact.lastAttributionSource.adGroupId}}Ad ID:
{{contact.lastAttributionSource.adId}}Facebook Click ID:
{{contact.lastAttributionSource.fbclid}}Google Click ID:
{{contact.lastAttributionSource.gclid}}Referrer:
{{contact.lastAttributionSource.referrer}}
Common Issues and Fixes
Custom Value Shows Blank
Cause: The data does not exist for that contact or event.
Fix: Ensure the field is populated before the workflow or campaign runs.
Phone Links Not Working
Cause: Formatted phone value used in a link.
Fix: Use {{contact.phone_raw}} for links and UTM parameters.
FAQ
Can I use custom values in both SMS and email?
Yes. Custom values work in SMS, email, workflows, and campaigns.
What value should I use for appointment reminders?
Use appointment values like {{appointment.start_time}}, {{appointment.meeting_location}}, and {{appointment.cancellation_link}}.
How do I include the account’s phone or address?
Use account values such as {{location.phone}} or {{location.full_address}}.
What are custom values and where can I use them?
Custom values are placeholders that automatically pull real data—such as contact details, user information, appointment data, account details, and timing values—into workflows, campaigns, and message templates.
How do I insert a contact’s full name in my messages or campaigns?
Use the custom value {{contact.name}} anywhere you want the contact’s full name to appear in a message, campaign, or workflow.
Can I customize appointment reminders using custom values?
Yes. You can use appointment custom values such as {{appointment.start_time}} to show the appointment start time or {{appointment.cancellation_link}} to include a cancellation link in appointment reminders.
How do I display account information in a workflow or message?
Use account custom values such as {{location.name}} for the account name or {{location.phone}} for the account phone number.
What custom value should I use to display the user’s email signature?
Use the custom value {{user.email_signature}} to insert the assigned user’s email signature into a message, workflow, or campaign.
Is there a way to include dynamic date and time values in my messages?
Yes. Use Right Now custom values such as {{right_now.day_of_week}}, {{right_now.hour_ampm}}, or {{right_now.year}} to dynamically insert the current date or time.
How can I include attribution data in my campaigns?
You can include attribution data using custom values such as {{contact.attributionSource.utmSource}} for first-touch UTM Source or {{contact.lastAttributionSource.gclid}} for the latest Google Click ID.
What’s the difference between {{contact.phone}} and {{contact.phone_raw}}?
{{contact.phone}} outputs a formatted phone number. {{contact.phone_raw}} outputs an unformatted number and should be used for links, trigger URLs, and UTM parameters.
Can I personalize calendar invites using custom values?
Yes. You can use {{appointment.add_to_google_calendar}} or {{appointment.add_to_ical_outlook}} to include one-click calendar add links in your messages.
How can I add the assigned user’s contact information in notifications?
Use appointment user custom values such as {{appointment.user.phone}} for the phone number or {{appointment.user.email}} for the email address.
How can I customize appointment rescheduling and cancellation links?
Use {{appointment.reschedule_link}} to include a reschedule link and {{appointment.cancellation_link}} to include a cancellation link in your notifications or workflows.
How can I use custom values to include contact information in my workflows or campaigns?
Use contact custom values such as {{contact.name}}, {{contact.email}}, {{contact.phone}}, or {{contact.address1}}. These values automatically pull the contact’s information when the workflow or campaign runs.