←Back to API docs

IMAP

IMAP connection

IMAP is used to read incoming SmakMail messages in an email client, CRM, or your own system. Messages stay on the server and remain available in the cabinet, Telegram bot, and other connections.

APIIMAPPOP3Status

Documentation

Connection settingsLogin and passwordWhen to use itLimitationsManual setupMessage headersCommon errors

Connection settings

Serverimap.smakmail.com
Port993
SecuritySSL/TLS
Loginfull email address
Passwordmailbox password from the order

Login and password

Always use the full email address as the login. Use the mailbox password from the issued order. The cabinet, Telegram, or account password is not suitable.

example@domain.com
example

When to use it

  • read messages in Thunderbird, Outlook, Apple Mail, or another email client
  • connect mailboxes to a CRM or internal system
  • receive messages without deleting them from the server
  • use one mailbox from several places

Limitations

  • IMAP does not send emails
  • IMAP does not create orders
  • IMAP does not issue new mailboxes
  • IMAP does not select domains
  • IMAP does not top up balance
  • Concurrent connections: Standard up to 10 per mailbox and user IP; Developer up to 50 per mailbox and user IP, with a soft account limit of 250 connections

Use the cabinet, Telegram bot, or API for orders, mailbox issuing, domain selection, and automation.

Manual setup

Choose manual mailbox setup in your email client. For port 993 use SSL/TLS. Do not use STARTTLS for port 993.

Type: IMAP
Incoming server: imap.smakmail.com
Port: 993
Security: SSL/TLS
Login: full email
Password: mailbox password from the order

Message headers

IMAP does not use HTTP headers. Through IMAP you can request the message headers: sender, recipient, subject, date, Message-ID, and other fields.

Use BODY.PEEK[HEADER] or BODY.PEEK[HEADER.FIELDS] to read headers without fetching the whole message body.

A1 LOGIN example@domain.com password
A2 SELECT INBOX
A3 UID SEARCH ALL
A4 UID FETCH 123 (BODY.PEEK[HEADER])
A5 UID FETCH 123 (BODY.PEEK[HEADER.FIELDS (FROM TO SUBJECT DATE MESSAGE-ID)])

Common errors

Incorrect login or password

Check that the login is the full email address, the password is taken from the order, and there are no extra spaces.

Cannot connect to server

Check server imap.smakmail.com, port 993, and SSL/TLS security. A different port or security mode may fail.

No messages in the client

Check that this mailbox has messages in the SmakMail cabinet or Telegram bot. Also check that the client uses the same email address issued in the order.

The client asks for SMTP

Some clients require outgoing mail settings. IMAP is not used for sending mail. If sending is not needed, skip SMTP when the client allows it.

Quick reference

IMAP server: imap.smakmail.com
Port: 993
Security: SSL/TLS
Login: full email
Password: mailbox password from the order