Campaigns

Pull live content into emails with data feeds

5 min read

A data feed is a web address (URL) on your own system that returns JSON. BlueyEmail reads it when the email is sent and drops the values into the email, so the content is always current.

Add a feed

  1. 1

    Open Settings → Data feeds

    Give the feed a short name, such as "deals". The name is what you type in your emails.

  2. 2

    Paste the URL

    It must start with https:// and return JSON. If the list of items sits inside the response, say where (for example data.items).

  3. 3

    Test it

    Choose Test the feed. You see how many items were found and every field, with tags ready to copy.

  4. 4

    Save it

    Choose how often it refreshes and what happens if your system cannot be reached, then Add feed.

Use it in an email

Email text
{{feed.deals.headline}}

{{#feed deals limit=3}}
  {{item.title}} - {{item.price}}
{{/feed}}
  • {{feed.<name>.<field>}} puts in one value. Dots reach inside: {{feed.deals.store.city}}.
  • {{#feed <name>}} … {{/feed}} repeats everything between the two tags for each item, up to 50 (or the limit you set). Inside it, {{item.<field>}} is that item's value.
  • Values are added as plain text, safely escaped, and never become merge tags themselves.

Personalised feeds

A personalised feed has contact tags in its URL, such as https://api.yourshop.com/offers?email={{email}} or {{custom.member_id}}, and is read once per contact. Values are URL-encoded. There is a per-feed limit on requests per minute; when it is reached the feed behaves as if it could not be reached.

When the feed cannot be reached

  • A normal feed falls back to the last content it read successfully.
  • Otherwise your setting decides: send anyway with the feed parts blank, or don't send that email. A campaign email that is held is retried later; an automation email is recorded as not sent.
  • Settings → Data feeds shows when each feed was last read and the last error.
PlanFeeds
FreeNot included
SparkFeeds read once for everyone
GrowFeeds read once for everyone
BusinessFeeds read once for everyone, and personalised feeds (one request per contact)

RSS-to-email is separate

To send a new email each time your blog posts, use RSS campaigns instead. If an RSS feed fails three checks in a row you now get a notification.

Still stuck? Our team is happy to help.

Contact support