CeanAI Documentation

Trigger an automated email. CeanAI looks up the automation matching the event type, fills the linked template with your data, and sends the email.

• event — required, must match an automation event type
• to — required, valid recipient email address
• data — optional object passed to the template variables
• idempotencyKey — optional string to prevent duplicate sends

Send a single email directly without using an automation or template. Useful for one-off or dynamic content.

const API_URL = 'https://api.ceanai.com/api/v1';
const API_KEY = 'your_api_key';

async function sendDirectEmail({ to, subject, html, from }) {
  const response = await fetch(`${API_URL}/emails/send`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY,
    },
    body: JSON.stringify({
      to,
      subject,
      html,
      from,
    }),
  });

  return response.json();
}

sendDirectEmail({
  to: 'user@example.com',
  subject: 'Welcome to MyApp',
  html: '<h1>Welcome!</h1><p>Thanks for joining.</p>',
  from: 'hello@yourdomain.com',
});

• to — required recipient
• subject — required email subject
• html — required HTML body
• from — required sender address on a verified domain
• text — optional plain text fallback
• replyTo — optional reply-to address

Other Endpoints