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
Open Settings → Data feeds
Give the feed a short name, such as "deals". The name is what you type in your emails.
- 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
Test it
Choose Test the feed. You see how many items were found and every field, with tags ready to copy.
- 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
{{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 thelimityou 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.
| Plan | Feeds |
|---|---|
| Free | Not included |
| Spark | Feeds read once for everyone |
| Grow | Feeds read once for everyone |
| Business | Feeds 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