API platform dashboard documentation for receiving and managing forwarded Gmail messages.
1. Login and API key
First login to receive the API key. Keep it private and send it in the x-api-key header.
curl -X POST https://app.msrfteam.l.cd/api/login -H "Content-Type: application/json" -d '{"username":"YOUR_USERNAME","password":"YOUR_PASSWORD"}'2. Mail commands
GET /api/healthzPOST /api/generateGET /api/addressesGET /inbox/<address>GET /email/<id>POST /api/delete-bulk
Create an address
curl -X POST https://app.msrfteam.l.cd/api/generate -H "x-api-key: YOUR_API_KEY"
Read Inbox or Spam
curl "https://app.msrfteam.l.cd/inbox/test1%40msrfteam.l.cd?folder=inbox" -H "x-api-key: YOUR_API_KEY"
The response contains 25 messages. Use nextPageToken with pageToken for the next page. Use folder=trash for the Trash view.
Open a message
curl https://app.msrfteam.l.cd/email/MESSAGE_ID -H "x-api-key: YOUR_API_KEY"
Move to Trash or delete permanently
curl -X POST https://app.msrfteam.l.cd/api/delete-bulk -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"ids":["MESSAGE_ID"]}'
curl -X POST https://app.msrfteam.l.cd/api/delete-permanent -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"ids":["MESSAGE_ID"]}'
3. Status and logs
curl "https://app.msrfteam.l.cd/api/status?address=test1%40msrfteam.l.cd" -H "x-api-key: YOUR_API_KEY" curl https://app.msrfteam.l.cd/api/logs -H "x-api-key: YOUR_API_KEY"
4. Required setup
ImprovMX must forward *.msrfteam.l.cd to the Gmail account used by the OAuth token. Render must contain GOOGLE_CREDENTIALS_JSON, GOOGLE_TOKEN_JSON, DOMAIN, API_KEY, and strong admin credentials.