Humanizer

The humanizer rewrites outgoing emails using an LLM to make them sound more natural. Instead of sending template output verbatim, the humanizer adjusts phrasing, tone, and structure while preserving your message's content and intent.

How it works

1. You send an email through the normal send endpoint with humanization enabled.
2. The humanizer rewrites the email body in your chosen style.
3. The rewritten version is sent to the recipient.

If rewriting fails for any reason, the original email is sent unchanged -- your delivery is never blocked by the humanizer.

Styles

The humanizer supports three styles. Pass one of these values as the style field in the config:

Configuration

View and update your humanizer settings with the CLI or API.

Get current config

molted humanizer get

curl https://api.molted.email/v1/agent/config/humanizer \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "enabled": true,
  "style": "professional",
  "provider": "anthropic"
}

Update config

molted humanizer update --config '{"enabled": true, "style": "friendly", "provider": "anthropic"}'

curl -X PUT https://api.molted.email/v1/agent/config/humanizer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "style": "friendly",
    "provider": "anthropic"
  }'

Updates are partial -- any field you omit keeps its current value. Unknown fields are rejected with a 400 error.

Enabling per send

Add the humanize and humanizeStyle fields to your send request to override tenant-level settings:

curl -X POST https://api.molted.email/v1/send/request \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "tenant_abc123",
    "recipientEmail": "user@example.com",
    "templateId": "follow-up",
    "dedupeKey": "followup-user@example.com",
    "payload": {
      "subject": "Following up",
      "html": "<p>Just checking in on our conversation last week.</p>",
      "text": "Just checking in on our conversation last week."
    },
    "humanize": true,
    "humanizeStyle": "friendly"
  }'

Per-send settings override tenant defaults. If the humanizer is enabled at the tenant level but a specific send sets humanize: false, that send will not be rewritten.

Related

• Sending Email -- send endpoints that support humanization
• Templates -- manage email templates
• Authentication -- how to get your API key