Page cover

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

  1. Find your AI coding agent (Cursor, Codeium, etc.)

  2. Copy the provided prompt

  3. 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.

Read Branding Guide β†’

πŸ§ͺ 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.

Try API Playground β†’

πŸ“š Complete API Reference

Detailed documentation for all endpoints, parameters, and response formats.

View API Reference β†’


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