Overview
Contacted Overview
Contacted transforms how you handle transactional emails. Instead of wrestling with templates and complex email builders, simply describe what you want in plain Englishβour AI handles the rest.
Two Ways to Get Started
Choose the path that works best for your workflow:
π€ Option 1: AI Agent Integration (8 Minutes)
Let AI agents like Cursor build your entire email system automatically
Find your AI coding agent (Cursor, Codeium, etc.)
Copy the provided prompt
Let the agent install and configure everything for you
Perfect for: Developers who want their entire email system coded and ready in under 8 minutes.
π Option 2: Manual Integration (30 Minutes)
Build your integration step-by-step following our guides
Start with our QuickStart guides below and customize as needed.
Perfect for: Developers who prefer hands-on control or need custom implementations.
How It Works
1. Describe Your Email Tell our AI what kind of email to create: "Generate a welcome email for a new premium user" or "Create a payment reminder with a friendly tone"
2. Add Your Data Pass user-specific information like names, dates, amounts, or linksβour AI weaves it all together seamlessly
3. Send Instantly Your personalized, branded email is generated and delivered automatically
QuickStart Guides
Python Example
import os
from contacted import ContactedAI
contacted = ContactedAI(
api_key=os.environ.get("CONTACTED_API_KEY")
)
contacted.send(
subject="Reset Password Notification",
from_email="<sender address>",
to_email="<receiver address>",
prompt="Password reset email. Include that it will expire in 20 minutes.",
data={
'link': 'https://example.com/reset?secret=1234565'
}
)
Node.js Example
const ContactedAI = require("contacted")
const contacted = new ContactedAI({
apiKey: process.env['CONTACTED_API_KEY']
});
const response = await contacted.send({
subject: "Welcome to Our Platform",
from: "<sender address>",
to: "<receiver address>",
prompt: "Welcome email for a new user who just signed up for our premium plan",
data: {
userName: "John Doe",
planName: "Premium",
nextBilling: "2025-07-15"
}
});
TypeScript Support
import ContactedAI, { SendOptions } from 'contacted';
const contacted = new ContactedAI({
apiKey: process.env.CONTACTED_API_KEY
});
const options: SendOptions = {
subject: 'Email subject line',
from: 'sender@example.com',
to: 'receiver@example.com',
prompt: 'Generate email content',
data: { name: 'John' }
};
const response = await contacted.send(options);
Essential Guides
π¨ Branding Guide
Learn how to create professional, branded email templates that reflect your company's identity. Our comprehensive branding guide walks you through customizing colors, fonts, logos, and layout elements to ensure every email maintains consistent brand recognition.
π§ͺ API Playground Guide
Master our interactive API Playground to test and perfect your email generation before deployment. Craft effective prompts, add dynamic data, preview emails in real-time, and copy implementation code for your application.
π Complete API Reference
Detailed documentation for all endpoints, parameters, and response formats.
Why Contacted?
π¨ Brand-Aware AI β Our AI learns your brand voice and creates emails that sound authentically you
β‘ Lightning Fast β Integrate transactional emails in minutes, not days or weeks
π Endlessly Flexible β From simple notifications to complex multi-section emails, our AI adapts to every use case
π§ͺ Test Before You Ship β Use our API playground to perfect your prompts before going live
Perfect For
Welcome sequences that make great first impressions
Payment reminders that actually get paid
Order confirmations with all the right details
Password resets that users can actually follow
Custom notifications tailored to your app's needs
Quick Start Cards
π Getting Started
Send your first email in minutes with our step-by-step guide Get Started β
π€ AI Agent Setup
Use Cursor or other AI agents to build your email system automatically Agent Setup β
π¨ Setup Branding
Learn best practices for matching your company's branding Branding Guide β
π API Reference
Complete documentation for integrating into your applications API Docs β
Ready to transform your email game? Choose your path above and send your first AI-generated email today.
Last updated