IMAP Access
Read your GetMailer inbound mail in Outlook, Apple Mail, Thunderbird, or any other IMAP client.
Overview
Every email delivered to your inbound-enabled domain is available over standard IMAP. Connect your favorite mail client with your GetMailer SMTP credentials and read, organize, and reply to inbound mail alongside your other accounts. The same credentials also work for sending: outgoing mail submitted over SMTP goes through the full GetMailer send pipeline, including your plan limits and suppression list.
IMAP access is available on all plans.
Prerequisites
- A verified domain with inbound enabled - set up your domain and MX records as described in Inbound Email
- An SMTP credential - go to Settings → SMTP and create one. The password is shown only once at creation, so store it in a safe place
Once at least one of your domains has inbound enabled, the Inbound IMAP card on the Settings → SMTP page shows your connection details.
Connection Settings
| Setting | Value |
|---|---|
| Incoming (IMAP) server | mail.getmailer.co |
| IMAP port | 993 (SSL/TLS) |
| Outgoing (SMTP) server | mail.getmailer.co |
| SMTP port | 465 (SSL/TLS) |
| Username | Your email address on the inbound-enabled domain (e.g. post@yourdomain.co) |
| Password | Your SMTP credential password |
Your smtp_... credential username also works as the IMAP username, but signing in with your email address is recommended - it sets the correct identity in your mail client automatically.
Folders and Sync Behavior
- INBOX - inbound mail arrives here. If your account has more than one inbound-enabled domain, mail for each domain is delivered to a separate folder named after that domain instead
- Junk - suspected spam is delivered to the Junk folder instead of INBOX
- Quarantined mail does not sync - review it under Settings → Inbound → Quarantine on getmailer.co
- Only new mail syncs - mail received before IMAP was enabled for your account does not appear in the client
- Read state syncs both ways - reading a message in your client or in the GetMailer web inbox marks it read in both, within a few minutes. Marking a message unread does not propagate
- Deletes are independent - deleting a message in your mail client does not delete it from the GetMailer web inbox
Outlook Setup
- Open Outlook and go to Add Account
- Enter your email address on the inbound-enabled domain (e.g.
post@yourdomain.co) - Choose advanced setup (or "let me set up my account manually") and select IMAP
- Incoming mail:
mail.getmailer.co, port993, encryption SSL/TLS - Outgoing mail:
mail.getmailer.co, port465, encryption SSL/TLS - Sign in with your email address as the username and your SMTP credential password
The same settings work in Apple Mail, Thunderbird, and any other standards-compliant IMAP client - the menus differ, the values do not.
Troubleshooting
Authentication fails
- Use your SMTP credential password, not your GetMailer account password and not an API key (
gm_...keys are for the REST API only) - The username must be an email address on a domain with inbound enabled, or your
smtp_...credential username - If you lost the password, delete the credential in Settings → SMTP and create a new one
No new mail arrives
- Check that your domain's MX records point to GetMailer - see Inbound Email
- Only mail received after IMAP was enabled for your account appears in the client
- Check the Junk folder and the Quarantine page under Settings → Inbound
Alternative: Inbox REST API
If you want to process inbound mail programmatically instead of reading it in a mail client, use the Inbox API with your API key:
curl "https://getmailer.co/api/v1/inbox?limit=20&status=unread" \ -H "Authorization: Bearer gm_your_api_key"
See Inbound Email for the full API reference, or Inbound Webhooks to have new mail pushed to your endpoint in real time.