---
title: "Generate email draft"
method: POST
path: "/api/v1/ai/generate"
tags: ["AI"]
---

# Generate email draft

`POST /api/v1/ai/generate`

Generates an email subject and HTML draft from campaign context and the active workspace brand settings.

## Request body

- GenerateEmailDraftRequest
  - `campaignGoal` string, required
  - `context` string, nullable
  - `link` string, uri, nullable
  - `templateId` string, nullable
  - `templateHtml` string, nullable
  - `templateSubject` string, nullable
  - `autoSelectTemplate` boolean
  - `personalizationMode` 'off' | 'lead_description_intro'

## Response `200`

Generated draft

- EmailDraft
  - `subject` string
  - `html` string
  - `generationMode` string

## Other responses

- `400` — Validation error
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/nudgen-marketing/apis/nudgen-developer-api.md) · [All operations](https://skmtc.net/nudgen-marketing/apis/nudgen-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nudgen-marketing/nudgen-developer-api/versions/f90a364e1720/schema)