Pre-arrival email

Add a banner in your pre-arrival email to introduce guests to the storyteller campaign and view other guests' stories.

A dynamically generated, linked image can be added to your email template that is unique for each guest and can be easily tweaked from your Flip.to account, including size, messaging and styling.

The image can also easily be toggled on and off. When off, a transparent 1x1 pixel is served.

Banner code snippet

The basic structure of the linked image to be added is:

<a href=”LinkURL”><img src=”ImageURL” alt=”ImageDescription”/></a>

LinkURL	Points guests to your story gallery: https://flip.to/property/prestay/email/link
ImageURL	Loads the image asset that introduces your storyteller campaign: https://flip.to/property/prestay/email/image
ImageDescription	Makes sure your image is screen-reader friendly and compliant with the Americans with Disabilities Act (ADA). Add in the alt attribute directly in the tag. We suggest the following alt text for the post-stay email image: alt=”You're invited to our next story contest! Just snap some memorable pics during your stay and we'll email you a few days after checkout with further details on how to submit your entry.”

Sample

<a target="_blank"
href="https://flip.to/property/prestay/email/link?companycode=XX&code=YY&pmsnumber=12345&crsnumbe
r=CRS56333&loyalty=70344&first=John&last=Smith&email=[e-mail]&startdate=2021-12-14&enddate=2021-12-
16&type=AB&ratecode=ABC&groupCode=Wedding&promoCode=flipto&language=en&currency=USD&amount=1234.45">
<img alt="Share about your upcoming trip with friends and family and they can unlock a special
bonus towards a future stay with us."
src="https://flip.to/property/confirmation/email/image?companycode=XX&code=YY&pmsnumber=12345&
crsnumber=CRS56333&loyalty=70344&first=John&last=Smith&email=[e-mail]&startdate=2021-12-14&
enddate=2021-12-16&type=AB&ratecode=ABC&groupCode=Wedding&promoCode=flipto&language=en&currency
=USD&amount=1234.45"/>
</a>

Parameters

Below are the parameters that should be appended to both the LinkUrl and ImageUrl. All values should be properly URL encoded.

Name	Value	Description
companyCode	Your Flip.to company code	Please check with your Customer Success Manager if needed and replace XX with your own companyCode.
code	The property code used by your booking engine	Replace YY with your own property booking engine code.
crsnumber	The reservation CRS number, if available
pmsnumber	The reservation PMS number, if available.
loyalty	Guest's loyalty program number, if any
first	Guest's first name
last	Guest's last name
email	Guest's email address	In cases that there may be more than one possible email available, this can be populated with a pipe (|) delimited list of emails. For example: email=[e-mail]|[e-mail]
startDate	Guest’s check-in date	Dates should be formatted as yyyy-M-d For example 2028-5-15 or 2028-05-15
endDate	Guest’s check-out date	If this is not available please see the nights parameter under advanced configuration below.
type	The guest’s room type, if available	This should include the booking engine internal code, and not the room type description.
rateCode	The guest’s rate code, if available
groupCode	The guest’s group code (or block code), if available
promoCode	The guest’s promo code, if available
language	The language ANSI code the guest has used to make the reservation	For English use en, French fr, etc. Here’s a complete list of ISO 639-1 language codes Optionally a culture name can be used as well. For example this can be set to en-US or en_US.
currency	The 3 character currency code the guest has used to made the purchase	Here's a complete list of currency codes. For instance USD for US Dollars.
amount	The total amount used for the purchase based on the defined currency	Amount should be supplied as a valid number including a decimal point if appropriate.

Advanced Configuration

Name	Value	Description
nights	Optional The number of nights that the guest has stayed at the hotel. This should be set as a number.	If endDate is not available, this field can be set to the actual or estimated (i.e. the average night stay) length of guest stay.
dateFormat	Optional Specifies a different date format for the startDate and endDate parameters.	By default dates should be specified as yyyy-M-d. However, you can change the default format by entering the appropriate format here. For example, if dates are entered as 12/31/2028 the date format to be specified is M/d/yyyy.
mobile	Optional Setting to true indicates that the mobile version of the image should be displayed. Default is a desktop image.	This is only supported for the ImageURL.
overrideImageUrl	Optional Overrides the default image with a custom image.	When using custom images, one should use the https protocol, and might want to create a unique image per language.