Quickstart

This guide takes you from a new account to a delivered email.

1. Add and verify your domain

In the dashboard, open Domains and add the domain you'll send from, such as acme.com. Jumploon shows three DNS records: DKIM, SPF and DMARC. Publish them at your DNS provider, then click Verify.

You can't send from a domain until its DKIM record is verified. SPF and DMARC are strongly recommended, but they don't block sending. See Domains & DNS for details.

2. Create an API key

Open API keys and create a key. For an app that only sends email, choose Send only. Copy the key right away: it's shown only once.

Store it as an environment variable:

export JUMPLOON_API_KEY="ju_xxxxxxxx_yyyyyyyy"

3. Send an email

Pick your language. Each example sends the same email.

Node.js

const res = await fetch("https://api.jumploon.com/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JUMPLOON_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "Acme <hello@acme.com>",
    to: ["ada@example.org"],
    subject: "Hello from Jumploon",
    html: "<p>It works!</p>",
  }),
});
 
console.log(await res.json()); // { id: "…" }

Python

import os
import requests
 
res = requests.post(
    "https://api.jumploon.com/emails",
    headers={"Authorization": f"Bearer {os.environ['JUMPLOON_API_KEY']}"},
    json={
        "from": "Acme <hello@acme.com>",
        "to": ["ada@example.org"],
        "subject": "Hello from Jumploon",
        "html": "<p>It works!</p>",
    },
)
print(res.json())  # {"id": "…"}

cURL

curl https://api.jumploon.com/emails \
  -H "Authorization: Bearer $JUMPLOON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["ada@example.org"],
    "subject": "Hello from Jumploon",
    "html": "<p>It works!</p>"
  }'

The response holds the email's ID:

{ "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c" }

4. Watch it arrive

Open Activity in the dashboard to see the message move through processed and delivered, and later opened and clicked if tracking is on. To receive these events in your own app, set up a webhook.

Next steps

Send with templates instead of inline HTML.
Send in batches or schedule for later.
Use SMTP from apps that can't call an HTTP API.