POST /v1/emails

{
  "from": "Your Name <sender@yourdomain.com>",
  "to": "recipient@example.com",
  "subject": "Your subject line",
  "html": "<p>Your HTML content</p>",
  "text": "Your plain text content",
  "replyTo": "replies@yourdomain.com",
  "cc": ["cc@example.com"],
  "bcc": ["bcc@example.com"],
  "headers": {
    "X-Custom-Header": "value"
  },
  "attachments": [
    {
      "filename": "invite.ics",
      "content": "QkVHSU46VkNBTEVOREFS...",
      "contentType": "text/calendar"
    }
  ]
}

{
  "success": true,
  "id": "ac5130c0-060b-40e1-ac7d-ab4204628dbc",
  "messageId": "010e01a0c45bc5c8-fad38ef0-7f65-4f1e-bfd4-43b891835314-000000"
}

GET /v1/emails/{id}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request body",
    "details": [
      {
        "field": "to",
        "message": "Invalid email address format"
      }
    ]
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

{
  "error": {
    "code": "domain_not_verified",
    "message": "The sender domain is not verified"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please try again later.",
    "retryAfter": 60
  }
}

curl -X POST https://api.envloped.com/v1/emails \
  -H "Authorization: Bearer en_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Your App <hello@yourdomain.com>",
    "to": "user@example.com",
    "subject": "Welcome to our service",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "text": "Welcome! Thanks for signing up."
  }'

async function sendEmail() {
  const response = await fetch('https://api.envloped.com/v1/emails', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ENVLOPED_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      from: 'Your App <hello@yourdomain.com>',
      to: 'user@example.com',
      subject: 'Welcome to our service',
      html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
      text: 'Welcome! Thanks for signing up.',
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }

  return response.json();
}

import os
import requests

def send_email():
    response = requests.post(
        'https://api.envloped.com/v1/emails',
        headers={
            'Authorization': f'Bearer {os.environ["ENVLOPED_API_KEY"]}',
            'Content-Type': 'application/json',
        },
        json={
            'from': 'Your App <hello@yourdomain.com>',
            'to': 'user@example.com',
            'subject': 'Welcome to our service',
            'html': '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
            'text': 'Welcome! Thanks for signing up.',
        }
    )

    response.raise_for_status()
    return response.json()

package main

import (
    "bytes"
    "encoding/json"
    "net/http"
    "os"
)

type EmailRequest struct {
    From    string `json:"from"`
    To      string `json:"to"`
    Subject string `json:"subject"`
    HTML    string `json:"html"`
    Text    string `json:"text"`
}

func sendEmail() (*http.Response, error) {
    email := EmailRequest{
        From:    "Your App <hello@yourdomain.com>",
        To:      "user@example.com",
        Subject: "Welcome to our service",
        HTML:    "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
        Text:    "Welcome! Thanks for signing up.",
    }

    body, _ := json.Marshal(email)

    req, _ := http.NewRequest("POST", "https://api.envloped.com/v1/emails", bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer "+os.Getenv("ENVLOPED_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    return http.DefaultClient.Do(req)
}