Omnisend setup guide

Connect Omnisend to flashtimer

Connect Omnisend once and flashtimer puts your countdown timers into Omnisend for you: into draft campaigns and automation emails as an HTML block, or into your email builder as a saved layout. The rest of your design stays as you built it. It takes about two minutes.

  • Every plan
  • Owners and admins
  • Your design stays
  • About two minutes
flashtimer connected to Omnisend: Every plan, Owners and admins, Your design stays, About two minutes.

Before you start

What you need

  • Owner or admin in flashtimer

    Connecting an integration is up to your organization's owners and admins.

  • An Omnisend login

    One that can open Store Settings → API keys in the Omnisend store whose emails should get your timers. If you can't, ask whoever manages the account.

  • Any flashtimer plan

    Connecting and saving timers as layouts in Omnisend are free. Adding timers to campaigns and automation emails from flashtimer is on Pro and up.

Step by step

Connect Omnisend

You make an API key in Omnisend, paste it into flashtimer and you're connected. If flashtimer's Omnisend dialog offers Connect with Omnisend, you can sign in to Omnisend and approve flashtimer instead, with no key to make.

  1. In flashtimer

    Step 1: Open Integrations and choose Omnisend

    In flashtimer, go to Settings → Integrations and open Omnisend.

    If the dialog offers Connect with Omnisend, click it, sign in to Omnisend if it asks, and approve flashtimer. There's no key to make: you come back to flashtimer connected, and can skip to step 4. Otherwise, keep this tab open and make a key in Omnisend.

  2. In Omnisend

    Step 2: Create an API key with every permission

    In Omnisend, open Store Settings → API keys and click Create API key.

    Tick every permission. flashtimer reads your email campaigns and automations, writes the timer into the email you pick, and saves the layouts you publish, so a key with only some permissions leaves part of that out. Create the key and copy it.

  3. In flashtimer

    Step 3: Paste the key and click Connect Omnisend

    Back in flashtimer's Omnisend dialog, paste the key into API key and click Connect Omnisend (Connect with API key where the dialog also offers Connect with Omnisend). flashtimer checks the key with Omnisend before it saves it.

    If Omnisend refuses it, check that you copied the whole key; see Troubleshooting for the rest.

  4. In flashtimer

    Step 4: Connected

    The dialog shows Connected. From now on, Send to ESP on a timer lists your Omnisend emails, and the timer page has an In Omnisend panel.

    Changes you make in Omnisend stay yours: flashtimer only changes the email you pick in Send to ESP and the layouts you publish from a timer. Before it writes, it checks the email hasn't changed since it read it, and asks you to preview again if it has.

Once connected

What you can do next

  • Put a timer into a draft campaign

    Pro and up

    Open a timer, click Send to ESP and choose Omnisend. Pick a draft email campaign, then click where the timer goes in the preview: between two sections, rows or blocks. flashtimer adds it there as an HTML block and leaves the rest of your drag-and-drop design as it was, so you keep editing the email in Omnisend as before. If the email is open in Omnisend's builder at the time, reload it there afterwards, or the open builder can save its older copy over the timer. Next to ✓ Embedded, Send me a test has Omnisend email it to you, and Open goes straight to that email in Omnisend.

  • Put a timer into an automation email

    Pro and up

    Send to ESP also lists the emails inside your automations, such as a welcome series or abandoned cart. Pick one and place the timer the same way. For automations, use an Evergreen timer: flashtimer adds vid=[[contact.email]] to its URL, so each contact gets their own countdown, starting at their first open. flashtimer hashes the address before it stores it, unless you turn on countdown events (below).

  • Save a timer as a layout in Omnisend

    Every plan

    On the timer page, the In Omnisend panel publishes the timer to your saved layouts in Omnisend's email builder, named after the timer: FlashTimer · Black Friday for a timer called Black Friday. Drag it into any campaign, automation or template. Edit the timer in flashtimer and every email that uses the layout shows the change: there's nothing to publish again.

  • Count down to a date each contact has

    Pro and up

    A dynamic timer counts down to a date stored on the contact, such as a reward expiry or a renewal. Its URL takes ?end= with the custom property's tag, for example ?end=[[contact.custom_properties.reward_expiry]]. The tag has to match the property's name exactly; a contact with no date, or a date that has passed, sees the expired frame, never a wrong countdown.

  • Start each email's countdown when Omnisend sends it

    Basic and up

    Choose Starts on send as the timer's timing. Omnisend fills in the moment it sends each email, so the timer goes in once, in a campaign, an automation email or a layout, and every email counts down from its own send: an automation email sent on Tuesday ends 48 hours after Tuesday's send. No send link is needed in Omnisend. Its URL carries ?sent=[[ current_date | date: '%s' ]]; Send to ESP, the In Omnisend panel and Embed add it for you.

  • Start automations from each contact's countdown

    Pro and up

    On an evergreen timer, turn on Send countdown events to Omnisend in the timer page's Countdown events panel. Omnisend then gets countdown started when a contact first opens the email, countdown ending soon 24 hours before their countdown ends (halfway, for one shorter than two days), and countdown ended, each with the timer and the contact's deadline. Start any automation from them. Create last-chance automation makes one for you, triggered by countdown ending soon, with the timer in its email; it's created as a draft, so review it and turn it on in Omnisend. Events go only to contacts already in Omnisend. While events are on, flashtimer keeps each contact's address encrypted until their countdown ends, then deletes it.

  • Keep a sign-up form's countdown on the timer's deadline

    Pro and up

    Omnisend's forms can't show the timer's image, but they have a Countdown block of their own. In the timer page's Countdown in Omnisend forms panel, link a form that has one, and flashtimer sets its countdown to the timer's deadline: the end date for a fixed timer, the duration for an evergreen one. Change the timer's deadline and the form follows. flashtimer changes only the countdown, checks the form afterwards, and puts it back as it was if anything else changed.

  • See how each email did

    Pro and up

    The timer page's Results in Omnisend panel shows, for each Omnisend email the timer is in, how many it was sent to, the open and click rates and the revenue Omnisend attributes to it, over the last 90 days. The numbers come from Omnisend and refresh every few hours.

  • Preview and send a test

    Every plan

    In Omnisend, preview the email and send a test to a Gmail and an Outlook address. Check that the timer shows the time left right now and, for an evergreen or dynamic timer, that the tag in the image address filled in. Then send the campaign or switch the automation on.

  • Paste it in yourself

    Every plan

    Click Embed on a timer, choose Omnisend as the email platform and copy the HTML. In Omnisend's email builder, drag in an HTML block and paste it. The Omnisend countdown timer guide covers campaigns and automations.

Manage

Manage the connection

Move or take out a timer
Send the timer to the same email again and the new one replaces the old one. On the timer page, Embedded in lists the Omnisend emails the timer is in, and you can remove it from one there.
Disconnect
In Settings → Integrations → Omnisend, click Disconnect. Timers already in your emails and layouts keep counting down, since flashtimer serves the image. If you connected with a key, remove it from Omnisend's API keys too.
Replace the key
Create a new key in Omnisend with every permission ticked. In flashtimer's Omnisend dialog, click Update key and paste it, then remove the old key in Omnisend. A connection made with Connect with Omnisend has no key: it offers Reconnect instead.
Use another Omnisend store
An organization connects one Omnisend store at a time. Disconnect, then connect again with a key from the other store.

Troubleshooting

If something doesn't work

Most problems show a message on flashtimer's Integrations page. Here's what each one means and what to do.

“Only owners and admins can change this connection.”
Connecting Omnisend is up to your organization's owners and admins. Ask one of them to connect it, or to make you an admin.
Omnisend refused the key
Check that you pasted the whole key with nothing cut off, and that it's still listed under Store Settings → API keys in Omnisend. If in doubt, create a new key with every permission ticked and connect with that.
It connected, but Send to ESP can't list or change my emails
The key is probably missing a permission. Create a new key in Omnisend with every permission ticked, click Update key in flashtimer's Omnisend dialog and paste it, then remove the old one.
“Omnisend won't let this email change in the state it's in”
Omnisend lets only a draft's email change. A campaign that has started sending is locked for good: copy it in Omnisend and send the timer to the copy. A scheduled campaign can go back to draft with Restore to draft in Omnisend. For an automation email, pause the automation, add the timer, then switch it back on.
My campaign isn't in Send to ESP
Send to ESP lists draft email campaigns, then the emails inside automations, then your saved templates. A scheduled campaign shows once it's back to draft (Restore to draft in Omnisend); a campaign that has started sending never does: copy it in Omnisend first. Search by the campaign's name.
Every contact sees the same countdown in my automation
The timer isn't evergreen, or its address lost Omnisend's tag. Make it Evergreen in flashtimer and check that the image address ends in vid=[[contact.email]], then send the timer to the email again. In Omnisend's preview, check that the tag fills in.
The timer doesn't move in Outlook
Classic Outlook for Windows (2007–2019, and newer versions with Windows animations turned off) shows only the first frame of a GIF. flashtimer makes that frame the correct time left at the moment of opening; it just doesn't tick. Restate the deadline in text, like "ends Sunday at midnight".
A reopen in Gmail shows an old time
It shouldn't: Gmail caches images through its proxy, so flashtimer serves the timer with no-cache headers and a reopen shows the current time. If a test shows a frozen timer, check that it's the flashtimer HTML and not a GIF uploaded to Omnisend, which never counts down.

Still stuck? Contact support.

Questions

Answered before you ask.