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) |
envelope | string | none | items: answer as { items, total, page, perPage }. Becomes the default on 2027-01-18. |
Example (cURL)
curl -X GET "$BASE_URL/api/organization/smtp/logs?limit=50&envelope=items" \
-H "Cookie: $SESSION_COOKIE" \
-H "Accept: application/json"Response
{
"items": [
{
"type": "smtp_send",
"timestamp": "2026-04-15T12:00:00.000Z",
"to": "admin@deinkunde.com",
"subject": "Website Down: deinkunde.com",
"status": "sent"
}
],
"total": 1,
"page": 1,
"perPage": 1
}List form: with envelope=items the list arrives as { items, total, page, perPage }. Without it the endpoint still answers the current form ({ "events": [...] }), which is deprecated; { items, ... } becomes the default on 2027-01-18.
Returns an empty list ("items": []; in the current form { "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.