Node.js SDK

import Migma from 'migma';

const migma = new Migma(process.env.MIGMA_API_KEY);

// A project holds your brand info (colors, fonts, logos, tone of voice).
// Import one from your website, or use an existing project ID from the dashboard.
const brand = await migma.projects.importAndWait({
  urls: ['https://yourbrand.com']
});

// Generate an email design with AI — returns the finished HTML directly.
const email = await migma.emails.generateAndWait({
  projectId: brand.data.projectId,
  prompt: 'Create a welcome email for new subscribers',
  languages: ['en']
});

if (email.data?.status === 'completed') {
  console.log('Subject:', email.data.result.subject);
  console.log('HTML:', email.data.result.html); // primary email HTML
  console.log('Email ID:', email.data.result.emails[0].emailId);
}

import Migma from 'migma';

const migma = new Migma(process.env.MIGMA_API_KEY);

// 1. Set up an instant sending domain (no DNS needed — see /sending-domains/overview)
await migma.domains.createManaged({ prefix: 'yourcompany' });

// 2. Generate an on-brand email with AI
const { data: email } = await migma.emails.generateAndWait({
  projectId: process.env.MIGMA_PROJECT_ID, // your brand project
  prompt: 'Create a summer sale email with 30% off everything',
});

if (!email?.result) throw new Error('Email generation failed');

// 3. Send it — emailId works for single emails and series slots
const selectedEmail = email.result.emails[0];
if (!selectedEmail.emailId) throw new Error('No emailId returned');
await migma.sending.send({
  recipientType: 'email',
  recipientEmail: 'sarah@example.com',
  from: 'hello@yourcompany.migma.email',
  fromName: 'Your Company',
  subject: selectedEmail.subject,
  emailId: selectedEmail.emailId,
});

const migma = new Migma('your_api_key', {
  baseUrl: 'https://api.migma.ai/v1', // default
  maxRetries: 2,     // retries on 5xx / 429 (default: 2)
  retryDelay: 1000   // delay between retries in ms (default: 1s)
});

const { data, error } = await migma.contacts.create({
  email: 'sarah@example.com',
  firstName: 'Sarah',
  status: 'subscribed', // only for contacts with marketing consent
  projectId: 'proj_123'
});

if (error) {
  console.error(error.code);       // e.g. 'validation_error'
  console.error(error.statusCode); // e.g. 400
  console.error(error.message);    // human-readable description
  return;
}

// TypeScript narrows — data is guaranteed non-null here
console.log(data.id);

const email = await migma.emails.generateAndWait(
  {
    projectId: 'proj_123',
    prompt: 'Create a product launch email'
  },
  {
    interval: 2000,     // poll every 2s (default)
    maxAttempts: 150,   // give up after 150 polls (default)
    onPoll: (status, attempt) => {
      console.log(`Poll ${attempt}: ${status.status}`);
    }
  }
);

const controller = new AbortController();
setTimeout(() => controller.abort(), 60000); // 60s timeout

const result = await migma.emails.generateAndWait(params, {
  signal: controller.signal
});

const { data: series } = await migma.emails.generateAndWait({
  projectId: 'proj_123',
  prompt: 'Create a three-email welcome series for new trial users',
  count: 3
});

if (series?.status === 'completed') {
  for (const email of series.result.emails) {
    console.log(email.slot, email.emailId, email.subject);
    console.log(email.html);
    console.log(email.screenshotUrl);
  }
}

const { data: email } = await migma.emails.get('email_123');
console.log(email.html);
console.log(email.screenshotUrl);

const edited = await migma.emails.edit('email_123', {
  prompt: 'Make this welcome email shorter and more transactional'
});

console.log(edited.data.html);

import Migma from 'migma';

const migma = new Migma(process.env.MIGMA_API_KEY);

// 1. Import your brand
const brand = await migma.projects.importAndWait({
  urls: ['https://yourbrand.com']
});
console.log('Brand imported:', brand.data.projectId);

// 2. Generate an email with AI
const email = await migma.emails.generateAndWait({
  projectId: brand.data.projectId,
  prompt: 'Create a password reset email',
  languages: ['en']
});
console.log('Email ready:', email.data.conversationId);
const selectedEmail = email.data.result.emails[0];
if (!selectedEmail.emailId) throw new Error('No emailId returned');

// 3. Send it
await migma.sending.send({
  recipientType: 'email',
  recipientEmail: 'sarah@example.com',
  from: 'hello@yourbrand.migma.email',
  fromName: 'Your Brand',
  subject: selectedEmail.subject,
  emailId: selectedEmail.emailId,
});

await migma.sending.send({
  recipientType: 'email',
  recipientEmail: 'sarah@example.com',
  from: 'hello@yourbrand.migma.email',
  fromName: 'Your Brand',
  subject: 'Reset your password',
  emailId: 'email_123'
});