Put our email editor inside your product

The Buildy SDK gives your customers a drag-and-drop email editor that exports responsive, table-based HTML and a plain-text part that work in every major inbox.

1. Create an app

Sign in, open Account, and create an app under “Embed the editor”. Add every website that will show the editor (for example https://app.example.com). Copy the client ID and secret — keep the secret on your server.

2. Get an editor token from your server

Tokens last 15 minutes. Request a fresh one each time someone opens the editor.

curl -X POST https://buildemail.online/api/public/embed/token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"bdy_...","client_secret":"bdy_sk_..."}'

# => { "token": "eyJ...", "expires_in": 900 }

3. Add the editor to your page

<div id="email-editor"></div>
<script src="https://buildemail.online/sdk/buildy.js"></script>
<script>
  const editor = Buildy.init({
    container: "#email-editor",
    token: TOKEN_FROM_YOUR_SERVER,
    locale: "en",            // "en", "pt-BR" or "es"
    height: "800px",
    design: savedDesignJson,  // optional: reopen a saved design
    mergeTags: [{ label: "First name", tag: "{{first_name}}" }],
    onReady: () => console.log("ready"),
    onChange: (design) => autosave(design),
    onSave: ({ design, html, text }) => store(design, html, text),
  });

  // Later:
  const { html, text, design } = await editor.export();
  editor.load(otherDesign);
</script>

What your users get

Title, paragraph, list, image, button, divider, spacer, social, HTML, video, icons, menu and GIF blocks.
One-, two- and three-column rows that stack on phones.
A text toolbar with bold, italic, links, colors and your own merge tags.
Outlook-safe buttons, hidden preview text support and a matching plain-text version.
English, Brazilian Portuguese and Spanish menus.

Security

The editor only loads on the websites you list, and only with a valid, unexpired token. Your secret never reaches the browser. Generate a new secret any time from your account.