Organization smtp
Get SMTP Send Logs
Returns recent SMTP send event logs from Redis. Admin-only.
GET /api/organization/smtp/logs
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 100 | Max events to return (1–500) |
Example (cURL)
curl -X GET "$BASE_URL/api/organization/smtp/logs?limit=50" \
-H "Cookie: $SESSION_COOKIE" \
-H "Accept: application/json"Response
{
"events": [
{
"type": "smtp_send",
"timestamp": "2026-04-15T12:00:00.000Z",
"to": "admin@example.com",
"subject": "Website Down: example.com",
"status": "sent"
}
]
}Returns { "events": [] } if no logs exist or on Redis errors (fails open).
Common errors
401 Unauthorizedwhen not authenticated403 Forbiddenwhen not an admin
Organization SMTP
Configure custom SMTP settings so your organization's notification emails are sent through your own mail server. All SMTP endpoints require admin role.
Test SMTP Connection
Tests the SMTP configuration by sending a test email. All parameters are optional — when omitted, stored config values are used. This allows testing new credentials before saving them. Admin-only.