HTML Importer API
Learn more about the HTML Importer API offering in Beefree SDK.
Last updated
Was this helpful?
Learn more about the HTML Importer API offering in Beefree SDK.
Last updated
Was this helpful?
Beefree SDK includes a comprehensive API offering designed to expand upon the builder's capabilities. By leveraging Beefree SDK's APIs, you can extend the builder's functionality into other aspects of your application.
Beefree SDK's API offering includes three APIs. They are the following:
This section of the documentation discusses the , which includes resources for programmatically importing pre-existing HTML templates into Beefree SDK's builder.
Import custom HTML into Beefree SDK
Export, convert, and style templates and rows. Use AI to generate metadata, SMS, and summaries.
Access Beefree's catalog of templates
Manually migrating your existing templates can be time-consuming, but with the HTML Importer API you can:
Make existing HTML editable in the Beefree SDK: Empower your end-users to edit their current HTML email templates using the intuitive drag-and-drop interface — without having to manually recreate them
Save time and resources: Manually recreating email templates from scratch can take hours. With the new Importer API, you can make existing email templates editable in Beefree in seconds.
Significantly reduce migration friction for faster client onboarding: Overcome the challenge of template migration, a common pain point when bringing on new clients. The HTML Importer API streamlines this process, allowing for quicker onboarding.
The resource in HTML Importer API is a synchronous endpoint that accepts the email HTML as the body of a POST request and returns the Beefree JSON in the response.
Using a simple API, you can pass us the email you'd like us to convert, and the API will return Beefree JSON in response:
Explore answers to the most frequently asked questions.
There are a few things you should be aware of to ensure a great import experience:
The conversion engine is designed to convert email HTML. It's not optimized for converting landing pages or other HTMLs.
Ensure your email HTML is valid. We can't import HTML files that miss DOCTYPE declaration, don't include valid html and body elements, or don't include the <meta charset="UTF-8"> tag in the head section of your HTML.
Our API doesn't convert dynamically created HTML documents that leverage JavaScript to render content. We currently support static HTML and CSS content only.
Ensure that all images and resources included in your HTML are publicly available on the internet. We can't convert emails with images and resources that are only available on private networks.
Please be aware that some HTML elements are not fully supported by the importer at this time, including background images, dividers, and menus.
If you follow the best practices above, the HTML Importer will migrate the structure and content of your HTML into Beefree's JSON format, significantly reducing the time it takes to recreate templates from scratch manually. Some design adjustments may still be necessary to match the original design.
Unsupported HTML tags do not break the endpoint as long as the overall HTML structure is valid. However, they may behave unpredictably and result in suboptimal imports. Implement validation and sanitization workflows for unsupported HTML tags to ensure proper handling.
No, with the HTML importer API, the result will stay consistent each time you call the API.
Yes, the HTML Importer API can be integrated with usage-based logic. For instance, you can track API calls by user ID and enforce usage limits based on predefined credit tiers. This logic should be implemented within your backend—for example, by maintaining a counter that increments with each API call to monitor and restrict access accordingly.
The HTML Importer API is available for all Beefree SDK plan types, including the free plan. We charge $2 per template import.
Every time you call our HTML Importer API and receive a JSON in response, that’s counted as an import for billing purposes.
If an API call fails for any reason (and we respond with an error rather than a JSON file), you won’t be charged.
No, we do not store any of your templates.
Images are not uploaded to Beefree SDK's file manager. They are referenced from the original source and must be publicly accessible on the internet to display correctly in the builder.
No, the HTML importer API does not use AI to recreate content into our native JSON format. Your templates will not be stored or used for training or data analysis purposes.
External CSS may only work if it is publicly hosted online, but its behavior is not guaranteed as it has not been thoroughly tested. It is best to inline CSS for reliable results. Merge tags are not supported during import but can be added afterward in the builder.
Dynamic content must be configured after import. The importer does not interpret or map dynamic content placeholders. You can apply dynamic content once the HTML is converted and editable in the Beefree SDK.
The HTML Importer API only supports plain HTML. If clients provide .eml or other formats, you’ll need to convert them to static HTML before importing. Consider developing preprocessing tools for recurring client onboarding.
✅ Yes, .
✅ Yes,.
✅ Yes, .
The HTML Importer API allows you to import your own HTML files into Beefree SDK. To use the HTML Importer API, you'll need to for the HTML Importer in the . Visit the to learn how to make API calls with the HTML Importer API.
The HTML Importer API is a -based API that enables Beefree SDK integrators to programmatically convert email HTML into Beefree JSON. It is built to follow predictable resource url patterns, and to utilize standard HTTP response codes and methods. This service is particularly helpful if you (or your end users) have pre-existing HTML templates you'd like to load within the no-code Beefree SDK builder and edit in the drag-and-drop editor.
Beefree SDK requires that you prior to accessing the HTML Importer API's resources and obtain an API key for your production application.
The following webinar utilizes the demo code in the to demonstrate an example of how to use the HTML Importer API along with the to create a compelling import and brand styling experience for your application's end users.
This section provides a high-level overview of the concepts related to the HTML Importer API. For detailed information on how to activate, use, and implement the endpoint, , which includes comprehensive implementation steps and considerations. The HTML Importer leverages a series of algorithms to map and classify all the content elements available in the email, label them, and then translate them into Beefree's JSON format.
You can use this tool in accordance with . In particular, you should use the tool in a way that ensures you will not violate the rights of third parties.
For more information on usage and pricing, visit the .
