This project provides an authenticated API for sending single and bulk emails using custom SMTP providers. Built with Django, Django Ninja, and JWT authentication.

🚀 Features

✅ Send single emails (plain text and HTML)
✅ Attach files via multipart/form
✅ Send bulk emails with multiple messages
✅ Auth-protected via JWT (django-ninja-jwt)
✅ Mail providers stored and managed via Django Admin

🔐 Authentication

Login to get token:

POST /api/token/pair
Content-Type: application/json

{
  "username": "youruser",
  "password": "yourpass"
}

Use the token to access protected endpoints:

Authorization: Bearer <access_token>

✉️ Sending Emails

🔹 Single Email (JSON)

POST /api/send-email
Authorization: Bearer <token>
Content-Type: application/json

{
  "from_email": "sender@example.com",
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "This is a plain text fallback",
  "html_body": "<p>This is <strong>HTML</strong></p>",
  "cc": null,
  "bcc": null,
  "attachments": []
}

🔹 Single Email (multipart/form)

curl -X POST http://localhost:8000/api/send-email-form \
  -H "Authorization: Bearer <token>" \
  -F "from_email=sender@example.com" \
  -F "to=recipient@example.com" \
  -F "subject=Hello" \
  -F "body=Hello plain" \
  -F "html_body=<h1>HTML</h1>" \
  -F "attachments=@file.pdf"

🔹 Bulk Email (JSON)

POST /api/send-bulk-email
Authorization: Bearer <token>
Content-Type: application/json

{
  "from_email": "sender@example.com",
  "messages": [
    {
      "from_email": "sender@example.com",
      "to": "a@example.com",
      "subject": "Hi A",
      "body": "Hello A!",
      "attachments": []
    },
    {
      "from_email": "sender@example.com",
      "to": "b@example.com",
      "subject": "Hi B",
      "body": "Hello B!",
      "attachments": []
    }
  ]
}

🛠 Mail Provider Setup

Add mail provider entries via Django Admin:

Field	Example
`host`	`smtp.gmail.com`
`port`	`587`
`use_tls`	✅ (True)
`host_user`	`user@gmail.com`
`host_password`	`your_app_password`
`from_email`	`user@gmail.com`