Project HermesHermes Docs
API ReferenceCampaigns

Create Campaign

Create a new email campaign

Create Campaign

Creates a new cold email campaign with scheduling and template configuration.

Request

  • name (string) (required) — Campaign name

  • subjectTemplate (string) (required) — Email subject line. Supports variables: {{firstName}}, {{lastName}}, {{company}}

  • bodyTemplate (string) (required) — Email body. Supports the same template variables.

  • timezone (string) (default: America/New_York) — Timezone for send windows (e.g., "Europe/London")

  • activeDays (string[]) (default: [) — Days of the week to send emails

  • startTime (string) (default: 09:00) — Start of daily send window (24h format)

  • endTime (string) (default: 17:00) — End of daily send window (24h format)

  • assignedMailboxes (string[]) — Array of mailbox IDs to send from

  • maxFollowups (integer) (default: 0) — Number of automatic follow-up emails

  • followupDelayDays (integer) (default: 3) — Days between follow-ups

curl -X POST https://api.hermes.camie.ai/v1/campaigns \
  -H "Authorization: Bearer hermes_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Solar Outreach Q1",
    "subjectTemplate": "Hi {{firstName}}, quick question about solar",
    "bodyTemplate": "Hi {{firstName}},\n\nI noticed your company...",
    "timezone": "America/New_York",
    "activeDays": ["mon","tue","wed","thu","fri"],
    "startTime": "09:00",
    "endTime": "17:00",
    "maxFollowups": 2,
    "followupDelayDays": 3
  }'

Response (201 Created)

{
  "success": true,
  "data": {
    "id": 2,
    "name": "Solar Outreach Q1",
    "status": "draft",
    "createdAt": "2026-03-14T17:00:00.000Z"
  }
}

On this page