Message Inbox

Simfra captures messages that would normally leave the system - SNS HTTP/HTTPS deliveries, SES emails, SMS notifications, subscription confirmations, and Cognito verification codes - in a unified inbox.

Accessing the Inbox

Click the inbox icon in the web console navigation bar. An unread count badge shows the number of new messages.

Message Types

Type	Source	Description
`ses-email`	SES	Emails sent via SES SendEmail/SendRawEmail
`sns-email-notification`	SNS	SNS notifications to email-subscribed endpoints
`sns-sms-notification`	SNS	SNS notifications to SMS-subscribed endpoints
`sns-subscription-confirmation`	SNS	Subscription confirmation requests for HTTP/HTTPS endpoints
`cognito-verification`	Cognito	User verification codes
`cognito-password-reset`	Cognito	Password reset codes
`cognito-welcome`	Cognito	Welcome messages
`organizations-welcome`	Organizations	Invitation messages for new member accounts

Inbox Actions

SNS Subscription Confirmations

When an SNS topic has an HTTP/HTTPS subscription, SNS sends a confirmation request. In the inbox, these messages include a Confirm action button. Clicking it confirms the subscription so it starts receiving notifications.

SES Emails

SES email messages display rendered HTML, headers, and attachment metadata.

API

All endpoints are under /_simfra/inbox.

List Messages

curl "http://localhost:4599/_simfra/inbox?type=ses-email&limit=10"

Query parameters:

Parameter	Description
`type`	Filter by message type (e.g., `ses-email`, `sns-subscription-confirmation`)
`source`	Filter by source service
`search`	Full-text search across subject and body
`limit`	Max messages to return (default 50, max 200)
`offset`	Pagination offset

Unread Count

curl http://localhost:4599/_simfra/inbox/unread-count

{"unreadCount": 3}

Mark as Read

# Single message
curl -X POST http://localhost:4599/_simfra/inbox/{id}/read

# All messages
curl -X POST http://localhost:4599/_simfra/inbox/read-all

Delete

# Single message
curl -X DELETE http://localhost:4599/_simfra/inbox/{id}

# All messages
curl -X DELETE http://localhost:4599/_simfra/inbox

Execute Action

curl -X POST http://localhost:4599/_simfra/inbox/{id}/action

For SNS subscription confirmations, this confirms the subscription.