The problem to solve
Direct mailbox integrations repeat authentication, connection and error-handling work in every project.
Integration guide
Python IMAP API
Retrieve mailbox messages as JSON from Python without maintaining a separate IMAP session in every script or worker.
Python IMAP APIapikey + apikeyboxPython requests → GET /getemail/
A practical implementation path
MailBridgeAPI keeps the authorized mailbox connection in one dashboard and gives backend applications account and mailbox API keys for documented HTTP endpoints.
01 — 03
From mailbox to working request
Connect the mailbox
Authorize the mailbox or configure its compatible SMTP and IMAP connection in the MailBridgeAPI dashboard.
Keep keys in the backend
Store the account API key and mailbox API key in server-side environment variables or a secret manager.
Call and verify the endpoint
Run the request, inspect the JSON response and keep the request or message identifier for support.
Python requests → GET /getemail/
Copy-ready example
Retrieve mailbox messages as JSON from Python without maintaining a separate IMAP session in every script or worker.
- One mailbox connection managed centrally
- API access without copying the mailbox password into every project
- Dashboard activity, errors and mailbox health
- A testable path from code to the real mailbox
import os, requests
response = requests.get(
'https://api.mailbridgeapi.com/getemail/',
params={
'apikey': os.environ['MAILBRIDGE_ACCOUNT_KEY'],
'apikeybox': os.environ['MAILBRIDGE_MAILBOX_KEY'],
'mbox': 'INBOX',
'start': 0,
},
timeout=30,
)
response.raise_for_status()
print(response.json())Provider and implementation limits
Folder names, message availability and quotas remain controlled by the mailbox provider. IMAP access must be enabled and compatible.
LIVE SMTP · IMAP · OAUTH DEMO
Test the real connection before you build
The live demo can validate SMTP, IMAP or a supported OAuth provider and issue temporary API keys without creating an account.