Email Sender API

The Email Sender API handles outgoing communications for Koveh Data Studio, supporting templated greetings and custom markdown-based messages.

Base URL

https://api.koveh.com/api/email-sender/

Authentication

All requests require the X-API-Key header.

X-API-Key: YOUR_API_KEY

Endpoints

1. Send Welcome Email

POST /send/welcome

Sends the predefined welcoming email. You can optionally override the recipient.

Body: {"to_email": "user@example.com"}

2. Send Follow-up Email

POST /send/followup

Sends the follow-up message to encourage engagement.

3. Send Custom Markdown Email

POST /send/custom

Sends a fully custom message using markdown formatting.

Request Schema:

{
  "to_email": "recipient@example.com",
  "subject": "Important Update",
  "markdown": "# Hello\nThis is a *custom* message.",
  "hero_headline": "Studio Update"
}

Logging

All sent emails are permanently archived in the sent_emails database table and backed up to sent_emails.json for audit and recovery purposes.