> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.brevo.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server. # Getting started 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](/reference/create-external-feed) 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: ```html ``` `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: ```yaml 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: ```python {{ 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: ```json "headers": [ { "name": "Authorization", "value": "Bearer " } ] ``` \ ### 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.](https://api.coingecko.com/api/v3/search/trending) **Step 1**: **Setup Feed** Add a new feed named `trendingcryptocoinsfeed`. ```curl 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/a26b3c21fcdc5609c614d7db7da65c7b7ee6de49c04468f24f1bce4076eb80f1/docs/assets/images/ba2f2c6-globalfeedscoins.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=ad92402fa43895c46edfb9a9d6110b6eb7b11aa5304f231df9e855dba4b2181c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/0dd3811b1136ac559dc8fb9ba7a97bd86ad051cee6665986d6e523ca694db22d/docs/assets/images/7d5f139-feedscryptohtml.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=0479b19ee8ec67b7c3c1c8bdca91ff8dee47a4e6b64dd8366f1e135eec431f84&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://help.brevo.com/hc/en-us/articles/360000591680) about repeat block] ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/dd13645e9be3f7d83de410b612755941c50f0b72a826e022d5e319cbfefbdc88/docs/assets/images/d57eb89-repeatblockfeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=c03af68c7d4139851fdd1bd9683c01865c0faa54533e8c0b503fcfd429dde11b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) Next, add the variables to the template. Since the variable alias `Trending` is already set up, use it to access feed variables. ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/f64ad4f2be76869562c8d696efd5d00bd55a035d3023b26f347e678bb9d36d07/docs/assets/images/df3cb13-variablesfeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=d5062ba90e43b877deb23090a06e436f9926ac561c8fb2afb69116051b7affb1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) The final email shows the top 5 trending crypto coins. ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/10d3e367a1bbad7c8c1a1e7385da17bd0f6a2e2fca5e89222b358a568b338449/docs/assets/images/0d28446-coinslistfeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=d6026c3a660862dd6f219237984f210f6297b8b76144e36655c9d6d935360384&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://help.brevo.com/hc/en-us/articles/360000591680) 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. ```html Information on crypto coins ``` The final email shows the top 5 trending crypto coins. \ ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/10d3e367a1bbad7c8c1a1e7385da17bd0f6a2e2fca5e89222b358a568b338449/docs/assets/images/0d28446-coinslistfeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=d6026c3a660862dd6f219237984f210f6297b8b76144e36655c9d6d935360384&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ### 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](https://api.coingecko.com/api/v3/coins/bitcoin). **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 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/0908ca422dc1a6b895ecf040f5c9ca198f2522f03bb5764bd88c413e7814f561/docs/assets/images/0380871-newattributefeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=4e714874e1cdc771c2db90d9d74f0ac43419a344973515ae18b57d6a4a25516e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/47a445a771a4e5e259939ed33ff885e07778e32789a9c8fe1a4298affc0a4a96/docs/assets/images/5a8cceb-favcoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=56d52195eb4c03f7a75d512a47ceca500ee3cd6f551aaef11ccc501e797d1a28&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/9f0e791478d0e56d62718237b3fe7871bd5dfb7b746e2fc672e6e860b026edf0/docs/assets/images/eb3ce3d-htmleditorfeeds.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=daf85f97d47cf433c53b80e034d516ebc16308e2b6ab7430bd096e62059e5167&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/62a55c4243282715279e1f44f0dda034108139b0bb4d2451959d2a682013ddd4/docs/assets/images/b28f81f-variablefeedsfavcoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=95d6f6c25ebd8fa94d9f12e05b6469fba752b2eb7d1c411706ce3278e589471b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) The final email shows unique crypto coin information for two different recipients. ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/182967f0fa9ea758385edd575fa89c979f9ada05ac12601de03e2e0c897a1d19/docs/assets/images/0c2df7d-tethercoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=d18a7901f02d13df007fa76d32303974091630f7714cd81ab11f3240f66aed79&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/fb67a7353bef2aca16fc152b327097a785294e92682fff348af02f7f89d9feb8/docs/assets/images/2676ad6-ethcoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=9f4d0e6d2bd7991860e0121c3d9c25a5fe9f815b0d25e2bdecbb85310284a6ec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **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. ```html Information on crypto coins ``` The final email shows unique crypto coin information for two different recipients. ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/182967f0fa9ea758385edd575fa89c979f9ada05ac12601de03e2e0c897a1d19/docs/assets/images/0c2df7d-tethercoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=d18a7901f02d13df007fa76d32303974091630f7714cd81ab11f3240f66aed79&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) \ ![Image](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/brevo.docs.buildwithfern.com/fb67a7353bef2aca16fc152b327097a785294e92682fff348af02f7f89d9feb8/docs/assets/images/2676ad6-ethcoin.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260922%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260922T133104Z&X-Amz-Expires=604800&X-Amz-Signature=9f4d0e6d2bd7991860e0121c3d9c25a5fe9f815b0d25e2bdecbb85310284a6ec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)