Skip to content
Maiilo Docs

Quickstart

This guide takes you from an empty account to a published template that your code can fetch.

1. Create a template

Section titled “1. Create a template”

Sign up at app.maiilo.io. New accounts start with an “Edit me” template you can use for this guide.

To start from scratch, go to Templates and create a new template. To start from HTML you already have, use Import HTML (Pro). See Code Block and HTML import.

2. Edit it in the builder

Section titled “2. Edit it in the builder”

Open the template to edit it in the builder. Drag in sections and elements, and click any element to edit it. There is no Save button: Maiilo saves your draft automatically a couple of seconds after each change. See Editor and autosave.

Set the subject line with Edit details in the template’s options menu. You can also add {{variables}} such as {{first_name}} for data you will fill in at send time. See Variables.

3. Publish

Section titled “3. Publish”

Press Publish in the builder toolbar and confirm. Maiilo freezes your draft into version v1. From now on, the API and SendGrid serve v1, even while you keep editing the draft. When you are ready to ship your changes, publish again to create v2.

See Publishing and versions.

4. Fetch it from your code

Section titled “4. Fetch it from your code”

Create an API key under API keys in the app, then request the template by its ID:

Terminal window
curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://app.maiilo.io/api/v1/templates/YOUR_TEMPLATE_ID"

The response contains the published version’s html, subject and variables. Replace the variables with your data and send the email with your provider of choice. See Get template by ID.

A template that has never been published returns 404 with {"error":"template_not_published"}. Publish it first.

5. Or push it to SendGrid (Pro)

Section titled “5. Or push it to SendGrid (Pro)”

If you send with SendGrid, connect your account under Integrations and press Push to SendGrid on the template’s details page. Maiilo creates a dynamic template in SendGrid holding your published version, and tells you whenever SendGrid falls behind a newer publish. See SendGrid.

What next

Section titled “What next”