Accounts and settingsExternal feeds

Getting started

View as Markdown

This guide covers how external feeds work and how to use them. Below are two methods to include an external feed in your emails.

Working with External feeds

Create an external feed using the API endpoint in the public API reference.

There are two ways to connect external feeds to email templates:


HTML editor

Add the following code before the HTML body:

<!--feed.myvariable : {{feed.get("feedname")}}-->

myvariable is the variable name used to access feed data, and feedname is the name of the feed you set up via the API endpoint.


Drag and drop editor

For the drag-and-drop editor, switch to developer mode and add the following code at the start of the template:

feeds:
  -
    name: myvariable
    source: feedname

myvariable is the variable name used to access feed data, and feedname is the name of the feed you set up via the API endpoint.

Accessing external feeds in email

To access data from external feeds, use the code below:

{{ feed.myvariable.field }}
{{ feed.myvariable.field.0.item }}

field is any field in the JSON. To access an item, suffix a 0-based index.

Errors in external feeds

Errors can occur at various steps when using an external feed. If an error occurs for a particular contact, that contact is skipped from the email campaign. If a general error affects all contacts, all recipients are skipped, and the reasons appear in the email report.

Common errors include:

  • The external feed does not exist or its definition is incorrect in the template.
  • External feed placeholders are defined incorrectly in the template.
  • An API issue prevents access to the external feed.

How to access external feeds with token authentication

When creating a feed, you can pass a bearer token in the headers for authentication. When the feed is called, the token is included in the headers and the API is called with the information provided. Example header:

"headers": [
  {
    "name": "Authorization",
    "value": "Bearer <token>"
  }
]

Frequently Asked Questions (FAQ)

For a campaign with 50,000 recipients, does Brevo send 50,000 HTTP requests to the external feed API, or one request that’s reused for all emails?

For a global feed: For n contacts, the server sends n requests to the API unless cache: 'true' is set when creating the feed. When caching is enabled, the feed data is cached for 1 hour (time-based TTL) — the cache does not expire based on the number of emails sent.

For personalized emails with attributes, does Brevo send one request per user or one per campaign?

For a personalized feed: Since the value differs per recipient, caching does not apply. The server sends one request per recipient even if cache is true.

After any feed change (create, update, or delete), the stale cache may persist for up to 1 hour before the new data is served.

If one request is sent per user, are the attributes passed to the external feed API as POST or GET parameters?

Only GET is supported. Variables are replaced server-side before the request is sent to the API — no variables are passed in the request.

If one request is sent per campaign and personalization is based on attributes mapped to the response JSON, how large can the response JSON be?

There is currently no size limit, but keep the response to required data only — larger responses increase latency.


Examples of Global and Dynamic feeds

Examples of implementing global and personalized external feeds.

Global feed example

This example creates an email campaign about the top 5 trending cryptocurrencies — a global feed where all recipients receive the same information.

The public API for this example is available at this url.

Step 1: Setup Feed

Add a new feed named trendingcryptocoinsfeed.

  curl --location --request POST 'https://api.brevo.com/v3/feeds' \
--header 'api-key: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "trendingcryptocoinsfeed",
    "url": "https://api.coingecko.com/api/v3/search/trending",
    "authType": "basic",
    "username": "test",
    "password": "test",
    "headers": [
        {
            "name": "abc",
            "value": "1"
        }
    ],
    "maxRetries": 1,
    "cache": true
}'

Step 2a: Connect external feed to the template (New D&D Editor)

Trendingcoins is the variable connected to the trendingcryptocoinsfeed feed. After setup, Trendingcoins contains all the data accessible in the template.

Image

Step 2b: Connect external feed to the template (HTML Editor)

Trendingcoins is the variable connected to the trendingcryptocoinsfeed feed. After setup, Trendingcoins contains all the data accessible in the template.

Image

Step 3a: Access feed data in the template (New D&D Editor)

Set up a repeat block in the template to show the first 5 crypto coins in the newsletter.

Display the following data in the newsletter:

  • Crypto coin image, name, symbol, and market-cap rank.

Define a For loop using the Repeat block feature. [Read more about repeat block]

Image

Next, add the variables to the template. Since the variable alias Trending is already set up, use it to access feed variables.

Image

The final email shows the top 5 trending crypto coins.

Image

Step 3b: Access feed data in the template (HTML editor)

Set up a repeat block in the template to show the first 5 crypto coins in the newsletter.

Display the following data in the newsletter:

  • Crypto coin image, name, symbol, and market-cap rank.

Define a For loop using the Repeat block feature. [Read more about repeat block]

Next, add the variables to the template. Since the variable alias Trending is already set up, use it to access feed variables.

<!--
   feed.Trendingcoins : {{ feed.get("trendingcryptocoinsfeed") }}
   -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office">
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <meta name="format-detection" content="telephone=no">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Information on crypto coins</title>
      <style type="text/css" emogrify="no">#outlook a { padding:0; } .ExternalClass { width:100%; } .ExternalClass, .ExternalClass p, .ExternalClass span, .ExternalClass font, .ExternalClass td, .ExternalClass div { line-height: 100%; } table td { border-collapse: collapse; mso-line-height-rule: exactly; } .editable.image { font-size: 0 !important; line-height: 0 !important; } .nl2go_preheader { display: none !important; mso-hide:all !important; mso-line-height-rule: exactly; visibility: hidden !important; line-height: 0px !important; font-size: 0px !important; } body { width:100% !important; -webkit-text-size-adjust:100%; -ms-text-size-adjust:100%; margin:0; padding:0; } img { outline:none; text-decoration:none; -ms-interpolation-mode: bicubic; } a img { border:none; } table { border-collapse:collapse; mso-table-lspace:0pt; mso-table-rspace:0pt; } th { font-weight: normal; text-align: left; } *[class="gmail-fix"] { display: none !important; } </style>
      <style type="text/css" emogrify="no"> @media (max-width: 600px) { .gmx-killpill { content: ' \03D1';} } </style>
      <style type="text/css" emogrify="no">@media (max-width: 600px) { .gmx-killpill { content: ' \03D1';} .r0-c { box-sizing: border-box !important; text-align: center !important; valign: top !important; width: 320px !important } .r1-o { border-style: solid !important; margin: 0 auto 0 auto !important; width: 320px !important } .r2-c { box-sizing: border-box !important; text-align: center !important; valign: top !important; width: 100% !important } .r3-o { border-style: solid !important; margin: 0 auto 0 auto !important; width: 100% !important } .r4-i { background-color: #ffffff !important; padding-bottom: 20px !important; padding-left: 15px !important; padding-right: 15px !important; padding-top: 20px !important } .r5-c { box-sizing: border-box !important; display: block !important; valign: top !important; width: 100% !important } .r6-o { border-style: solid !important; width: 100% !important } .r7-i { padding-left: 0px !important; padding-right: 0px !important } .r8-i { padding-bottom: 15px !important; padding-top: 15px !important } .r9-c { box-sizing: border-box !important; text-align: left !important; valign: top !important; width: 100% !important } .r10-o { border-style: solid !important; margin: 0 auto 0 0 !important; width: 100% !important } .r11-i { padding-bottom: 0px !important; padding-top: 15px !important; text-align: left !important } .r12-i { padding-bottom: 15px !important; padding-top: 15px !important; text-align: left !important } .r13-i { background-color: #eff2f7 !important; padding-bottom: 20px !important; padding-left: 15px !important; padding-right: 15px !important; padding-top: 20px !important } .r14-i { padding-bottom: 0px !important; padding-top: 15px !important; text-align: center !important } .r15-i { padding-bottom: 0px !important; padding-top: 0px !important; text-align: center !important } .r16-i { padding-bottom: 15px !important; padding-top: 15px !important; text-align: center !important } .r17-c { box-sizing: border-box !important; text-align: center !important; width: 100% !important } .r18-i { padding-bottom: 15px !important; padding-left: 0px !important; padding-right: 0px !important; padding-top: 0px !important } .r19-c { box-sizing: border-box !important; text-align: center !important; valign: top !important; width: 129px !important } .r20-o { border-style: solid !important; margin: 0 auto 0 auto !important; width: 129px !important } body { -webkit-text-size-adjust: none } .nl2go-responsive-hide { display: none } .nl2go-body-table { min-width: unset !important } .mobshow { height: auto !important; overflow: visible !important; max-height: unset !important; visibility: visible !important; border: none !important } .resp-table { display: inline-table !important } .magic-resp { display: table-cell !important } } </style>
      <!--[if !mso]><!-->
      <style type="text/css" emogrify="no"> </style>
      <!--<![endif]-->
      <style type="text/css">p, h1, h2, h3, h4, ol, ul { margin: 0; } a, a:link { color: #40464d; text-decoration: underline } .nl2go-default-textstyle { color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 16px; line-height: 1.5 } .default-button { border-radius: 4px; color: #ffffff; font-family: arial,helvetica,sans-serif; font-size: 16px; font-style: normal; font-weight: normal; line-height: 1.15; text-decoration: none; width: 50% } .default-heading1 { color: #1F2D3D; font-family: arial,helvetica,sans-serif; font-size: 36px } .default-heading2 { color: #1F2D3D; font-family: arial,helvetica,sans-serif; font-size: 32px } .default-heading3 { color: #1F2D3D; font-family: arial,helvetica,sans-serif; font-size: 24px } .default-heading4 { color: #1F2D3D; font-family: arial,helvetica,sans-serif; font-size: 18px } a[x-apple-data-detectors] { color: inherit !important; text-decoration: inherit !important; font-size: inherit !important; font-family: inherit !important; font-weight: inherit !important; line-height: inherit !important; } .no-show-for-you { border: none; display: none; float: none; font-size: 0; height: 0; line-height: 0; max-height: 0; mso-hide: all; overflow: hidden; table-layout: fixed; visibility: hidden; width: 0; } </style>
      <!--[if mso]>
      <xml>
         <o:OfficeDocumentSettings>
            <o:AllowPNG/>
            <o:PixelsPerInch>96</o:PixelsPerInch>
         </o:OfficeDocumentSettings>
      </xml>
      <![endif]-->
      <style type="text/css">a:link{color: #40464d; text-decoration: underline;}</style>
   </head>
   <body text="#3b3f44" link="#40464d" yahoo="fix" style="">
      <table cellspacing="0" cellpadding="0" border="0" role="presentation" class="nl2go-body-table" width="100%" style="width: 100%;">
         <tr>
            <td align="center" class="r0-c">
               <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="600" class="r1-o" style="table-layout: fixed; width: 600px;">
                  <tr>
                     <td valign="top" class="">
                        <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                           {% for Trending in feed.trendingcoins.coins | slice:":5" %}
                           <tr>
                              <td class="r2-c" align="center">
                                 <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r3-o" style="table-layout: fixed; width: 100%;">
                                    <!-- -->
                                    <tr>
                                       <td class="r4-i" style="background-color: #ffffff; padding-bottom: 20px; padding-top: 20px;">
                                          <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                             <tr>
                                                <th width="50%" valign="top" class="r5-c" style="font-weight: normal;">
                                                   <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r6-o" style="table-layout: fixed; width: 100%;">
                                                      <!-- -->
                                                      <tr>
                                                         <td valign="top" class="r7-i" style="padding-left: 15px; padding-right: 15px;">
                                                            <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                                               <tr>
                                                                  <td class="r2-c" align="center">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="270" class="r3-o" style="table-layout: fixed; width: 270px;">
                                                                        <tr>
                                                                           <td class="r8-i" style="font-size: 0px; line-height: 0px; padding-bottom: 15px; padding-top: 15px;"> <img src="{{Trending.item.large}}" width="270" border="0" class="" style="display: block; width: 100%;"></td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                            </table>
                                                         </td>
                                                      </tr>
                                                   </table>
                                                </th>
                                                <th width="50%" valign="top" class="r5-c" style="font-weight: normal;">
                                                   <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r6-o" style="table-layout: fixed; width: 100%;">
                                                      <!-- -->
                                                      <tr>
                                                         <td valign="top" class="r7-i" style="padding-left: 15px; padding-right: 15px;">
                                                            <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="left" valign="top" class="r11-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 16px; line-height: 1.5; padding-top: 15px; text-align: left;">
                                                                              <div>
                                                                                 <p style="margin: 0; font-size: 22px;">{{Trending.item.name}}</p>
                                                                                 <p style="margin: 0; font-size: 22px;"> </p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="left" valign="top" class="r12-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 16px; line-height: 1.5; padding-bottom: 15px; padding-top: 15px; text-align: left;">
                                                                              <div>
                                                                                 <p style="margin: 0;"><strong>Market cap wise rank :</strong><br />{{Trending.item.market_cap_rank}}</p>
                                                                                 <p style="margin: 0;"> </p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                            </table>
                                                         </td>
                                                      </tr>
                                                   </table>
                                                </th>
                                             </tr>
                                          </table>
                                       </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                           {% endfor %}
                           <tr>
                              <td class="r2-c" align="center">
                                 <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r3-o" style="table-layout: fixed; width: 100%;">
                                    <!-- -->
                                    <tr>
                                       <td class="r13-i" style="background-color: #eff2f7; padding-bottom: 20px; padding-top: 20px;">
                                          <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                             <tr>
                                                <th width="100%" valign="top" class="r5-c" style="font-weight: normal;">
                                                   <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r6-o" style="table-layout: fixed; width: 100%;">
                                                      <!-- -->
                                                      <tr>
                                                         <td valign="top" class="r7-i" style="padding-left: 15px; padding-right: 15px;">
                                                            <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="center" valign="top" class="r14-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 18px; line-height: 1.5; padding-top: 15px; text-align: center;">
                                                                              <div>
                                                                                 <p style="margin: 0;"><strong>Coin</strong> <strong>Desk</strong></p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="center" valign="top" class="r15-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 18px; line-height: 1.5; text-align: center;">
                                                                              <div>
                                                                                 <p style="margin: 0; font-size: 14px;">2848 Brown Bear Drive</p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="center" valign="top" class="r14-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 18px; line-height: 1.5; padding-top: 15px; text-align: center;">
                                                                              <div>
                                                                                 <p style="margin: 0; font-size: 14px;">This email was sent to {{contact.EMAIL}}</p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="center" valign="top" class="r15-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 18px; line-height: 1.5; text-align: center;">
                                                                              <div>
                                                                                 <p style="margin: 0; font-size: 14px;">You've received this email because you've subscribed to our newsletter.</p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r9-c" align="left">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r10-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td align="center" valign="top" class="r16-i nl2go-default-textstyle" style="color: #3b3f44; font-family: arial,helvetica,sans-serif; font-size: 18px; line-height: 1.5; padding-bottom: 15px; padding-top: 15px; text-align: center;">
                                                                              <div>
                                                                                 <p style="margin: 0; font-size: 14px;"> <a href="{{ unsubscribe }}" style="color: #40464d; text-decoration: underline;">Unsubscribe</a></p>
                                                                              </div>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                               <tr>
                                                                  <td class="r17-c" align="center">
                                                                     <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="100%" class="r3-o" style="table-layout: fixed; width: 100%;">
                                                                        <tr>
                                                                           <td valign="top" class="r18-i" style="padding-bottom: 15px;">
                                                                              <table width="100%" cellspacing="0" cellpadding="0" border="0" role="presentation">
                                                                                 <tr>
                                                                                    <td class="r19-c" align="center">
                                                                                       <table cellspacing="0" cellpadding="0" border="0" role="presentation" width="129" class="r20-o" style="table-layout: fixed;">
                                                                                          <tr>
                                                                                             <td height="48" class="" style="font-size: 0px; line-height: 0px;"> <img src="https://img.mailinblue.com/new_images/rnb/en.png" width="129" border="0" class="" style="display: block; width: 100%;"></td>
                                                                                          </tr>
                                                                                       </table>
                                                                                    </td>
                                                                                 </tr>
                                                                              </table>
                                                                           </td>
                                                                        </tr>
                                                                     </table>
                                                                  </td>
                                                               </tr>
                                                            </table>
                                                         </td>
                                                      </tr>
                                                   </table>
                                                </th>
                                             </tr>
                                          </table>
                                       </td>
                                    </tr>
                                 </table>
                              </td>
                           </tr>
                        </table>
                     </td>
                  </tr>
               </table>
            </td>
         </tr>
      </table>
   </body>
</html>

The final email shows the top 5 trending crypto coins.


Image

Personalized feed example

This example creates an email campaign with each contact’s favorite cryptocurrency — a dynamic feed where each recipient receives unique, personalized information.

The public API for this example is available at this url.

Step 1: Setup feed

Add a new feed named favcryptocoinsfeed. Note the contact attribute {{contact.FAVCOIN}} in the URL — it is replaced with the contact’s favorite coin at send time, generating unique data per recipient.

curl --location --request POST 'https://api.brevo.com/v3/feeds' \
--header 'api-key: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "favcryptocoinsfeed",
    "url": "https://api.coingecko.com/api/v3/coins/{{contact.FAVCOIN}}",
    "authType": "basic",
    "username": "test",
    "password": "test",
    "headers": [
        {
            "name": "abc",
            "value": "1"
        }
    ],
    "maxRetries": 1,
    "cache": true
}'

Step 2: Prepare contact recipients

Add a new attribute FAVCOIN and set its value for each recipient of the newsletter.

Image

Step 3a: Connect external feed to the template (New D&D Editor)

Favcoin is the variable connected to the favcryptocoinsfeed feed. After setup, Favcoin contains all the data accessible in the template.

Image

Step 3b: Connect external feed to the template (HTML Editor)

Favcoin is the variable connected to the favcryptocoinsfeed feed. After setup, Favcoin contains all the data accessible in the template.

Image

Step 4a: Access feed data in the template (New D&D Editor)

Display the following data from the feed in the newsletter:

  • Crypto coin image, name, symbol, market-cap rank, price, description, and homepage link.

Add the variables to the template. Since the variable alias Favcoin is already set up, use it to access feed variables.

Image

The final email shows unique crypto coin information for two different recipients.

Image

Image

Step 4b: Access feed data in the template (HTML Editor)

Display the following data from the feed in the newsletter:

  • Crypto coin image, name, symbol, market-cap rank, price, description, and homepage link.

Add the variables to the template. Since the variable alias Favcoin is already set up, use it to access feed variables.

The final email shows unique crypto coin information for two different recipients.

Image


Image