🚀 New: Check out our API product page

Learn about pricing, use cases, and see what developers are building

API v1

API Documentation

Technical documentation for integrating Folderly EmailGen AI into your applications. Generate personalized cold emails and multi-step sequences programmatically.

Quick Start

1. Get your API key from the dashboard

Navigate to Account → API Keys to create your first key

2. Make your first request

curl -X POST https://generate.folderly.com/api/v1/emails/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persona": "Head of Sales",
    "offer": "AI-powered sales automation platform that increases team productivity by 40%",
    "goal": "Book a 15-minute demo to show how we can help your team"
  }'

3. Get your generated email

{
  "success": true,
  "data": {
    "emailContent": "Hi [Name],\n\nI noticed you're leading sales at [Company]...",
    "subjectLine": "Boost Your Sales Team's Productivity by 40%",
    "evaluation": {
      "spamScore": 2.3,
      "effectiveness": "High",
      "toneAnalysis": "Professional"
    }
  }
}
POST/api/v1/emails/generate5 credits

Generate a single personalized email

Request Body

{
  "persona": "string (required)",     // Target persona (e.g., "CTO", "Marketing Manager")
  "offer": "string (required)",       // Your value proposition
  "goal": "string (required)",        // Desired outcome
  "tone": "string",                   // Optional: professional, casual, friendly
  "industry": "string",               // Optional: Target industry
  "additionalContext": "string"       // Optional: Extra context
}

Response

{
  "emailContent": "string",
  "subjectLine": "string",
  "evaluation": {
    "spamScore": 2.3,
    "toneAnalysis": "professional",
    "effectiveness": "high",
    "improvements": ["Add specific metrics", "Include social proof"]
  },
  "industry": {
    "detected": "SaaS",
    "confidence": 0.95,
    "benchmarks": {
      "openRate": 42.3,
      "replyRate": 12.1
    }
  }
}
POST/api/v1/emails/sequence10 credits

Generate a multi-step email sequence

Request Body

{
  "persona": "string (required)",
  "offer": "string (required)",
  "goal": "string (required)",
  "steps": 5,                         // Number of emails (3-7)
  "sequenceStrategy": "value_ladder"  // Strategy type
}

Ready to Get Started?

Generate your first AI-powered email in minutes