Read Live Emails via IMAP: Connects to your configured IMAP mailbox to fetch live emails, using your Email Server settings in UMVA.

Endpoint: POST /messages/read

Parameters (JSON body):

• api_key (required, string): Your Email Messaging API key.
• type (required, string): Must be "email".
• recipient (required, string): Email address associated with the mailbox (e.g. support inbox).
• server_username (required, string): IMAP username (e.g. [email protected]) as configured in Email Server settings.
• limit (optional, integer): Maximum number of messages to fetch.

Example Request:

curl -X POST "https://umva.net/api/messaging/messages/read" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_EMAIL_API_KEY",
    "type": "email",
    "recipient": "[email protected]",
    "server_username": "[email protected]",
    "limit": 5
  }'

Notes: This feature requires IMAP configuration on your Email Server settings. UMVA uses those credentials to connect and read messages. Use a dedicated mailbox for programmatic access where possible.