How to Send Email from Your Lovable App

These commands run on your local machine, not inside Lovable. You only do this once.

Set up AWS

If you already have AWS configured, skip this. AWS setup guide →

Deploy email infrastructure

npx @wraps.dev/cli email init

Sets up SES in your account and verifies your sending domain. This is where your emails actually send from — your AWS, your domain. Domain verification guide →

Connect to the Wraps Platform

npx @wraps.dev/cli platform connect

Creates a cross-account IAM role so the Wraps Platform can send email through your SES when a workflow fires. Run this once — re-run wraps platform update-role if you add new features later.

In the Wraps dashboard, go to Settings → API Keys and create a new key. Name it something like lovable-app.

Lovable apps run on Supabase. Go to your Supabase Dashboard → Edge Functions → Secrets and add:

WRAPS_API_KEY = wraps_a1b2c3d4....<hmac>

Create a Supabase Edge Function

Create a track-event Edge Function. Lovable's AI can write this for you — just describe what you want.

import { serve } from "https://deno.land/std@0.168.0/http/server.ts";

serve(async (req) => {
  const { name, contactEmail, contactName, properties } = await req.json();

  const res = await fetch("https://api.wraps.dev/v1/events/", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${Deno.env.get("WRAPS_API_KEY")}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name,
      contactEmail,
      contactName,
      createIfMissing: true,
      properties,
    }),
  });

  const data = await res.json();
  return new Response(JSON.stringify(data), {
    headers: { "Content-Type": "application/json" },
  });
});

Call it when things happen in your app

From your Lovable frontend, call the Edge Function when events occur:

import { supabase } from "@/lib/supabase";

// When a user signs up
await supabase.functions.invoke("track-event", {
  body: {
    name: "user.signed_up",
    contactEmail: user.email,
    contactName: user.name,
    properties: { plan: "free", source: "lovable" },
  },
});

// When an order is placed
await supabase.functions.invoke("track-event", {
  body: {
    name: "order.placed",
    contactEmail: user.email,
    properties: { orderId: order.id, amount: order.total },
  },
});

In the Wraps dashboard, create a workflow with an event trigger set to your event name (e.g. user.signed_up). Add a Send Email step with your template. That's it — every time your app emits that event, Wraps sends the email.

Custom events guide →

1. 1Dashboard → Workflows → New workflow
2. 2Trigger: Event received → event name: user.signed_up
3. 3Step: Send email → choose your template