Connect your Omnisend account to Appstle Loyalty & Rewards to send your loyalty emails from Omnisend. Each time a loyalty email is due, Appstle sends an event to Omnisend with the email's content. You build an automation in Omnisend that starts from that event and sends the email.
Important: With Omnisend connected, Appstle doesn't send loyalty emails itself. A customer gets an email only if you've built and turned on an Omnisend automation for its event.
Before you start
Have an Omnisend account you can sign in to.
Turn on the Appstle Loyalty app embed in your theme. While it's off, Appstle sends no loyalty events. See Set up your loyalty program.
In More → Email Templates, keep on each email you want to send. Appstle sends an email's event only while that email is turned on.
Connect Omnisend
In Omnisend, open Apps, search for Appstle Loyalty & Rewards and click Connect Now.
Copy the API key that Omnisend shows.
In Appstle Loyalty & Rewards, go to More → App Integrations.
On the Omnisend Email Marketing & SMS card, click Set up. The Omnisend Account page opens.
Paste the key into API Key.
Click Save in the bar at the top of the page.
Back in Omnisend, on the Appstle Loyalty & Rewards app page, check I have completed all the steps and click Confirm.
This is the Omnisend Account page from steps 4 and 5.
Appstle checks the key with Omnisend when you save. If Omnisend accepts it, the card shows Enabled. Appstle then sends one sample event for each loyalty email to the address [email protected], so that every event appears in Omnisend's list of triggers. A contact with that address can appear in your Omnisend account.
You can also create the key yourself in Omnisend, under Store settings → API keys. Give it the Contacts and Events permissions, and copy it before you close the screen, because Omnisend shows it only once. When you save, Appstle checks only the Contacts permission. Without Events, no event reaches Omnisend.
Set up your automations in Omnisend
Appstle sends one event for each type of loyalty email. In Omnisend, create a workflow for each email you want to send: open Automations, click Create workflow, choose Create from scratch, pick the matching event as the trigger, and add an email. Turn the workflow on when you're done.
This list shows each email in More → Email Templates, when Appstle sends it, and the name of its event.
Welcome Email: a customer signs up. Event:
appstle_loyalty_welcome_eventPoint Earn: a customer earns points. Event:
appstle_loyalty_point_earn_eventCredits Earn: a customer earns store credit. Event:
appstle_loyalty_credits_earn_eventPoint Redeem: a customer redeems points. Event:
appstle_loyalty_point_redeem_eventReward Available Reminder: a customer gets a new reward. Event:
appstle_loyalty_reward_available_reminder_eventMonthly Reward Reminder: a reminder of a customer's points and rewards. Event:
appstle_loyalty_monthly_reward_reminder_eventPoints Expiring Reminder: before a customer's points expire. Event:
appstle_loyalty_reward_expiring_reminder_eventDiscount Expiring Reminder: before a customer's discount code expires. Event:
appstle_loyalty_discount_expiring_reminder_eventBirthday: on the customer's birthday. Event:
appstle_loyalty_birthday_reward_eventSend referral invite to new customer: a customer invites a friend. Omnisend gets it for the friend's address. Event:
appstle_loyalty_referral_link_send_eventReferral Acceptance Confirmation for new customer: tells the friend the referral was accepted and that they need to create an account. Event:
appstle_loyalty_referred_reward_eventReferral Acceptance Confirmation for existing customer: tells the customer who referred a friend that the friend accepted. Event:
appstle_loyalty_referral_reward_eventVIP Tier Achieved: a customer reaches a VIP tier. Event:
appstle_loyalty_vip_tier_achieved_eventVIP Tier Expiring Reminder: before a customer's VIP tier expires. Event:
appstle_loyalty_vip_tier_expiring_reminder_eventVIP Tier Upgrade Reminder: encourages a customer to earn more points to reach the next tier. Event:
appstle_loyalty_vip_tier_upgrade_reminder_event
Omnisend lists a custom event as a trigger only after it has fired once. Appstle fires each one when you save your key. If one is missing from the list, send a test email for it (see Troubleshooting).
Use the sample template
Each event carries what the matching Appstle email would show: the subject, heading and text from Email Templates, the colors and logo, the customer's name and points, and the reward or tier details. Your Omnisend email shows them with placeholders such as [[event.heading]]. Many of the event's properties are described in List of Variables for Omnisend.
To start from a ready-made design, open the Omnisend Account page and click Create Sample Template. The template appears in the Sample template box. Click Copy above the box. It's a complete HTML email that works as the starting point for any of the loyalty emails.
Omnisend's HTML block takes only what's between the <body> and </body> tags, so paste that part. Omnisend's help explains how to add custom HTML to an email. Check the result with a test email before you turn the workflow on.
Loyalty details on Omnisend contacts
Appstle also keeps three details up to date on a customer's Omnisend contact, as long as the customer already exists in Omnisend: availablePoints (their available points), availableStoreCredits (their store credit balance, when they have one) and dob (their birthday, when you have it). You can use them in Omnisend segments and emails.
Disconnect Omnisend
Clear the API Key on the Omnisend Account page and click Save. Appstle adds an Integration Disabled entry to More → Activity Logs. From then on, Appstle sends your loyalty emails itself, or through Klaviyo or Mailchimp if you've connected one of them.
Things to know
Klaviyo and Mailchimp both come before Omnisend. While either is connected, Appstle sends no events to Omnisend. The badge next to the Email Templates title shows which service is in use.
The email your customer receives is the one in your Omnisend workflow. Changes you make in More → Email Templates reach Omnisend as event details, and show only where your Omnisend email uses them.
The Reply To Email and From Email settings of an email don't apply. Set the sender in Omnisend.
The Admin Notification / BCC Email you set for an email no longer gets a copy. If Only Send this email as Admin Notification? is on, Appstle sends the event for that address instead of the customer.
Omnisend sends a workflow that starts from a custom event to unsubscribed contacts by default. If you don't want that, click the trigger block of the workflow and change its Workflow Channel Settings. Omnisend's help on custom events explains how.
Workflows you built before Appstle's latest Omnisend update may start from events with names like "Point earn event from Appstle Loyalty". They keep working, but open each one and select its event again from the list above. That's what the Omnisend Integration Update banner on App Integrations asks you to do.
Troubleshooting
"Omnisend rejected this API key or its permissions." Create a new key in Omnisend under Store settings → API keys, with the Contacts and Events permissions, and paste it again.
"We couldn't reach Omnisend to check these details." Wait a few minutes and save again.
"Omnisend didn't accept these details." Check the key and save again.
"Copy the complete API key without spaces or line breaks." Paste only the key, in one piece, with no spaces or line breaks inside it.
An event isn't in Omnisend's list of triggers. In Appstle, open the email in More → Email Templates, click Test Email, choose an address under To Email and click Send. That sends the event once, for the address you chose.
Customers don't get loyalty emails. Check that the badge next to the Email Templates title says Omnisend enabled, and that the workflow for that event exists and is on in Omnisend. Then open More → Activity Logs, find the email's entry for that customer, and follow the matching item below.
The entry says "Email sent successfully through omnisend integration". Appstle sent the event, but it doesn't check whether Omnisend accepted it. In Omnisend, check that your API key still exists and has the Events permission, and that the workflow is on. If the key is gone, create a new one and save it in Appstle.
The entry says "Email sending failed". If the note ends with "as template is not enabled", the email is turned off in More → Email Templates. Otherwise Appstle couldn't reach Omnisend, and that email isn't sent again. Click View Details on the entry to see the reason.
The entry says the email can't be sent. Appstle didn't send the event, and the note says why:
the email is turned off in More → Email Templates, or its Restrict Customer Tags or Allow Customer Tags leave the customer out
the customer isn't covered by Send Emails To in More → Advanced Settings, or Enable Email is off for them
the customer has unsubscribed or their address bounces
the Appstle Loyalty app embed is off, or Show loyalty on your store is off in Design
FAQs
Do I need to build the automations myself?
Yes. Appstle only sends the events. Without a workflow for an event in Omnisend, no email goes out for it.
Can I use Omnisend and Appstle's own emails together?
No. While Omnisend is connected, Appstle sends events instead of its own emails. To have Appstle send them again, disconnect Omnisend as described above.
What does Appstle do in my Omnisend account?
It sends the events above, updates the three details on existing contacts, and reads one contact when you save a key, to check that the key works. It doesn't create workflows or change yours.

