HTML Importer API

Learn more about the HTML Importer API offering in Beefree SDK.

Available on all Beefree SDK plan types. Learn more about Usage-based fees for the HTML Importer API.

Beefree SDK API Offering

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:

• Content Services API

• Template Catalog API

• HTML Importer API

This section of the documentation discusses the HTML Importer API, which includes resources for programmatically importing pre-existing HTML templates into Beefree SDK's builder.

Diagram Displaying Beefree SDK's API Offering

Overview of HTML Importer API

Manually migrating your existing templates into Beefree SDK can be tedious and 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 HTML Importer API is a REST-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 authenticate prior to accessing the HTML Importer API's resources. You can generate API keys for both production and development applications. API keys associated with development applications are intended for pre-production environments and endpoint testing. They should not be used in production environments.

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.

How the HTML Importer API works

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.

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:

FAQs

Explore answers to the most frequently asked questions.

Can I convert any HTML template? Are there any limitations?

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.

Will I get different results if I upload the same HTML template to the API several times?

No, with the HTML importer API, the result will stay consistent each time you call the API.

What's the applicable use policy?

You can use this tool in accordance with Beefree's Terms of Service. In particular, you should use the tool in a way that ensures you will not violate the rights of third parties.

Which plan has access to the API, and what's the pricing?

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.

For more information on usage and pricing, visit the Usage-based fees article.

Do you store any of the templates I upload to the HTML Importer?

No, we do not store any of your templates.

Does the HTML Importer API use AI, and are you using my templates for training?

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.