Skip to main content
Private Preview — This feature is currently in private preview. APIs and behavior may change.
npm install @insforge/sdk@latest

import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-app.insforge.app',
  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
});

​
emails.send()

Send custom HTML emails to one or more recipients.

​
Parameters

  • to (string | string[], required) - Recipient email(s), max 50 recipients
  • subject (string, required) - Email subject line, max 500 characters
  • html (string, required) - HTML content of the email
  • cc (string | string[], optional) - CC recipient(s), max 50 recipients
  • bcc (string | string[], optional) - BCC recipient(s), max 50 recipients
  • from (string, optional) - Custom sender name, max 100 characters
  • replyTo (string, optional) - Reply-to email address, must be a valid email address
When Custom SMTP is enabled for your project, the from field is ignored — the sender name and email are always taken from your SMTP configuration to prevent spoofing through your server.

​
Returns

{
  data: {} | null,  // Empty object on success
  error: Error | null
}

​
Example

const { data, error } = await insforge.emails.send({
  to: ['user1@example.com', 'user2@example.com'],
  cc: 'manager@example.com',
  from: 'Acme Support Team',
  subject: 'Team Update',
  html: '<h1>Weekly Update</h1><p>Here are this week\'s highlights...</p>',
  replyTo: 'support@example.com'
});

if (error) {
  console.error('Failed to send email:', error.message);
  return;
}

console.log('Email sent successfully');