↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect a mailbox to Elbuz

    8 min readUpdated

    Elbuz reads your mailbox and sends email from it: a two-step wizard, and customer emails appear in “Mail”. Fourteen services get servers and ports automatically.

    When you need this:

    • Gmail, Outlook or Ukr.net — the tile fills in servers; add the address and an app password.
    • A mailbox on your store's domain — “Other” plus four values from your hosting.
    • Several mailboxes — “Default” picks the sender for templates.
    • A mailbox stopped responding — after 60 failures in a row it's disabled, with the reason.
    • A mailbox for price lists only — emails aren't downloaded, files arrive.

    Where to start: Organizer → Mail → “Connect a mailbox”.

    What the mail connection can do

    • Connection wizard — the provider tile fills in servers and ports, and the “Connect” button checks the connection right away.
    • Mail on your own domain — the “Other” tile and server values from your hosting provider.
    • Mailbox card — everything the wizard doesn't cover: folders, sender name, open tracking.
    • Email download — turn it off for a mailbox used only for price lists, or set how many days back to fetch emails the first time.
    • “Check Connection” — checks the incoming and outgoing mail servers separately.
    • Several mailboxes — which mailbox sends the email in each case.
    • New emails — when the app fetches mail from the server.

    How to connect a mailbox with the wizard

    Until there is at least one active mailbox with email download turned on, the “Mail” window shows an explanation instead of an empty table: “Set up your mail client”, three steps, and the “Connect a mailbox” button.

    Two-step wizard

    Step one is “Provider”. Fifteen tiles: Gmail, Outlook / Office 365, iCloud Mail, Yahoo, Zoho Mail, GMX, Ukr.net, Meta.ua / i.ua, WP.pl, Onet.pl, Interia.pl, WEB.DE, Fastmail, AOL Mail and “Other” → “Set up manually”. Clicking a tile fills in the server addresses and ports — no need to type them.

    The
    1Gmail tile
    2Other tile (set up manually)
    3Hint above the tiles
    1. Gmail — one of the ready-made providers; its server settings are filled in automatically.
    2. Other — pick this tile when your provider is not listed and you want to enter the server settings manually.
    3. Hint above the tiles — choose your email provider and the server settings are filled in for you.

    The IMAP port is 993 for every provider on the list. The port is mostly 465, but 587 for Outlook, iCloud and WEB.DE.

    Eight services require a separate app password: Gmail, Outlook, iCloud, Yahoo, Zoho, Ukr.net, Fastmail and AOL. For them the wizard shows the hint “This provider requires an app password (for third-party apps), not your regular account password.” and an “Official setup guide” link to the provider's own page.

    For most, that page is the app password instructions; for Ukr.net it's just the mail home page. These services simply won't accept your regular password.

    Step two is “Account”: “Email address”, “Password”, “Sender name”. Below them is a collapsed “Server settings (IMAP/SMTP)” block with addresses, ports and the “Use SSL” switch. For the “Other” tile this block is open right away.

    Mail on your own domain at a hosting provider. A mailbox like sales@your-store.com issued by your hosting isn't on the provider list — pick the “Other” tile → “Set up manually”.

    • On the “Account” step, enter the mailbox address and password, and in the “Server settings (IMAP/SMTP)” block — “IMAP server”, “IMAP port”, “SMTP server”, “SMTP port” and the “Use SSL” state.
    • Your hosting provider gives you these values: they are in the mail section of the hosting control panel or in its help.
    • Without an IMAP server the wizard won't continue and replies “Enter the IMAP server (or pick a provider).”.
    • If your domain's mail is handled by Gmail or Outlook / Office 365 rather than the hosting itself, pick that service's tile — the address can be on your domain.

    The “Connect” button does four things at once: creates the mailbox, saves the data, turns on background mail fetching and checks the connection. You get two lines — “IMAP: Connection successful!” and “SMTP: …” — in green or red. On success the wizard shows “Mailbox connected! Loading your mail…”, the folder tree reloads and the first sync starts.

    When the wizard is opened from a price list card, it works differently: it connects the mailbox without email download, because there it's needed only for price list attachments. Such a mailbox won't appear in the “Mail” window, and background mail fetching isn't turned on for it.

    How to change mailbox settings

    Anything the wizard doesn't cover is edited in the mailbox card. To open it: the “Mail settings” gear → “Email users”. The “Email users list” window opens; double-click a row to open the mailbox card. The card has four blocks: “General”, “Credentials”, “Incoming mail server (IMAP)”, “Outgoing mail server (SMTP)”.

    Mailbox card fields and default values
    FieldWhat it isDefault
    “Active”the mailbox is workingon
    “Default”template emails go out from this mailbox when the template doesn't specify another oneoff
    “Username”, “Password”sign-in for both IMAP and SMTP — one pair for both serversempty
    “Server address” and “Port” in the IMAP blockwhere incoming mail is fetched fromport 993
    “Server address” and “Port” in the SMTP blockwhat mail is sent throughport 465
    “SSL required”affects the incoming mail server check and receiving price lists by email; doesn't affect sendingon
    “Inbox folder”, “Sent folder”folder names on the serverINBOX and Sent
    “Download emails to Elbuz”whether to fetch this mailbox's emails into the “Mail” windowon; off if the mailbox was connected from a price list card
    “First download, days”how many recent days of email to fetch the first time; 0 means the full history90
    “Sender name”, “Sender”what the recipient sees in the “From” fieldfilled in by the wizard
    “Track opens”add a transparent pixel to the email that shows the email was openedthe wizard turns it on

    The card has no separate save button: the form saves itself about a second after each edit — at the bottom you'll see “Saving…”, then “Saved”, or “Save error” if something fails.

    The app puts a copy into “Sent” on the server through the incoming mail server from the mailbox card — it takes the address and port from the IMAP block. So keep the IMAP server filled in, even if the mailbox is only used for sending.

    If it's empty, the app derives the address from the SMTP address by replacing smtp. with imap.: this works for Gmail (smtp.gmail.com → imap.gmail.com) and Ukr.net, but not for Outlook or GMX, and your mailbox's “Sent” folder won't get a copy. Inside Elbuz the email stays where it is.

    Email download: turn it off or set the period

    Both fields are in the “Incoming mail server (IMAP)” block.

    Mailbox card: the hint, the “Download emails to Elbuz” switch and the “First download, days” field
    1Download emails to Elbuz
    2First download, days
    1. Download emails to Elbuz — the switch is on, so incoming emails are loaded into the built-in mail client.
    2. First download, days — how many days of history to load the first time (90 here); 0 means the full history.

    “Download emails to Elbuz”. Turn it off for a mailbox used only for supplier price lists or sending. Both keep working: the app takes attachments straight from the mail server. Emails take no database space, and a mailbox without downloaded emails isn't shown in “Mail”. Turned off later, it keeps existing folders and emails; only new ones stop.

    Mailboxes added before 04.11.2026 that never downloaded any email were turned off by the app automatically. To read their mail in Elbuz, turn the switch on in the mailbox card.

    “First download, days”. How many recent days of email the first sync fetches. Default 90, so a large mailbox doesn't flood the database; 0 means the full history. Raise it for a downloaded mailbox, and the next sync brings older emails. Existing ones aren't duplicated, except an email moved to another folder after download. Lowering it deletes nothing.

    The “Check Connection” button

    The button is in the mailbox card; the result appears in the “Info” block. It tests the incoming and outgoing servers separately, hence two lines. Success: “Connection successful!”; failure: “IMAP Error: …” or “SMTP Error: …” with the server's exact text. No server filled in — “Fill in the required fields!”.

    A green check doesn't mean emails will go out. The check encrypts the same way real sending does: on port 465, SSL right away; on any other port (587, 25, 2525), STARTTLS. So for a given port, the check and sending connect the same way.

    But the check only connects to the server and signs in to the mailbox — it doesn't send an email. So test with a first real email, not the button.

    If the card has a server filled in but the login or password is empty, the “Info” block shows an orange line “Fill in the mailbox login and password — the connection cannot be checked without them.” Fill in “Username” and “Password” first, then check.

    Several mailboxes: which one sends the email

    You can connect as many mailboxes as you like. The catch is that there is not one sender rule but three, and which applies depends on where you write from.

    Which mailbox sends the email
    Where the email comes fromWhich mailbox
    A reply, or a new email from an open folderthe mailbox whose folder you're in
    The “Write an email” button in a customer cardthe first mailbox in the “Mail” window's folder tree, usually the one connected earliest — the “Default” checkbox has no effect here. If there are no folders yet — the first working one by IMAP server name in alphabetical order
    A template email: newsletter, trigger, email from a documentthe mailbox selected in the template's “Sender's E-Mail” field; if it was turned off — the mailbox with the “Default” checkbox; if there's no default — any active one

    The “Default” checkbox is easy to miss. While you have one mailbox, it makes no visible difference. As soon as a second one appears, template emails start going out “from any active one” — that is, whichever the app finds first. If you have more than one mailbox, set the checkbox explicitly.

    When you change the default mailbox, the app asks: “Mail templates still bound to the previous server (ID …): N. Move them to this server?” with the “Move” and “Leave as is” buttons. Only templates tied to the former default are moved; a template where you deliberately chose another mailbox stays as it was.

    If no mailbox is fit for sending, a template email won't go out, and the operation log gets the entry “Email not sent: no usable mailbox or required fields are empty” — the parentheses after it list what's missing:

    SMTP, login, password, from, to, subject, body. Fit means all at once: active, with login, password, SMTP server and sender address filled in. The same entry appears if the template itself has an empty subject or body, or the recipient couldn't be determined.

    When new emails arrive in Elbuz

    The key thing to understand right away: Elbuz fetches mail continuously in the background only when the “Receiving email (IMAP)” job is on. Without it, emails arrive while you work in the “Mail” window.

    • background job “Receiving email (IMAP)” — runs every two minutes and goes through all mailboxes with email download turned on;
    • clicking a folder in the tree — the app goes to the server and fetches new emails for that folder;
    • “Load new messages” in the “Additional Operations” menu above the folder tree — goes through the same mailboxes once;
    • opening the “Mail” window — sync starts on its own if the account has no mail folders yet, or a mailbox was added less than a day ago and has no folders yet.

    The job turns on by itself when you first connect a mailbox for reading: active, download on, IMAP server, login and password filled in, no folders yet. If its emails were downloaded before and the job is off, saving the card won't turn it on. The job isn't in the “Job schedule” window: it's a system job.

    “New emails received” notifications arrive when an email is downloaded, so without the background job they appear after someone opens a folder or clicks “Load new messages”.

    Per run, the app sends no more than ten such notifications per mailbox; each employee turns them on in their own card with the “New emails received” checkbox in the “Select events to send notifications” block.

    The first sync of a folder fetches emails for as many days as set in the “First download, days” field, in pages of 200 emails. After that, only emails since the last download are fetched.

    While a mailbox is syncing, no new on-demand sync starts. If you click a folder during that time, you'll see “Mail synchronization is already running. Please wait until it finishes.”, and “Load new messages” shows the same as a red line prefixed with the mailbox address. A stuck sync releases the queue after 30 minutes.

    Scenarios

    Connect Gmail

    Task. The store uses Gmail and wants to see customer emails in Elbuz.

    What to do. Create an app password in your Google account's security settings. Then Organizer → Mail → “Connect a mailbox” → the Gmail tile; on the “Account” step — address, app password, “Sender name” → “Connect”.

    Result. Two green lines, IMAP and SMTP, then “Mailbox connected! Loading your mail…”, and the first sync starts on its own. Send yourself a first real email: a green check doesn't guarantee sending.

    A second mailbox for newsletters

    Task. Managers write to customers from the main mailbox, while newsletters should go out from a separate one.

    What to do. Connect the second mailbox with the wizard. On the main one, set the “Default” checkbox. In the newsletter template, select the second mailbox in the “Sender's E-Mail” field.

    Result. The newsletter goes out from the second mailbox, other template emails from the main one. An email from a customer card goes out from the first mailbox in the folder tree: the checkbox doesn't affect it.

    You got a “Mailbox disabled” notification

    Task. The app failed to connect to the IMAP server 60 times in a row and cleared “Active” on the mailbox.

    What to do. Read the reason in the notification. Open the “Mail settings” gear → “Email users” → the mailbox card, fix the server address or password, click “Check Connection” and turn “Active” back on.

    Result. The first successful connection resets the failure counter, and emails start arriving again.

    A mailbox only for supplier price lists

    Task. A supplier sends the price list by email, and there's no need to read this mail in Elbuz.

    What to do. Connect the mailbox right from the price list card: the wizard turns off email download itself. If the mailbox already exists, turn off the “Download emails to Elbuz” switch in its card.

    Result. The price list file arrives as before, but emails aren't downloaded into the database, and a mailbox with no downloaded emails isn't in the “Mail” window.

    What to do when a mailbox won't connect or an email isn't sent

    What the app says and what to do about it
    What you seeWhyWhat to do
    “Enter your email address and password.” one of the two fields on the wizard's “Account” step is empty fill in both (connection wizard)
    “Enter the IMAP server (or pick a provider).” the “Other” tile is selected, but no server was entered manually enter the server, or go back and pick your provider (connection wizard)
    “IMAP Error: ‹server text›” the mail server didn't let the app into the mailbox Gmail, Outlook, iCloud, Yahoo, Zoho, Ukr.net, Fastmail and AOL need an app password, not your regular one (connection wizard)
    “SMTP Error: ‹server text›” the outgoing mail server refused access check the SMTP address and port: usually 465, 587 for Outlook, iCloud and WEB.DE (mailbox card)
    “Fill in the required fields!” “Check Connection” was clicked, but no server is specified enter at least the incoming mail server (connection check)
    “Fill in the mailbox login and password — the connection cannot be checked without them.” the server is specified, but the login or password is empty fill in “Username” and “Password” (connection check)
    “Mail server not found — it may have been deleted. Close this window and pick a server from the list again.” the card was opened for a mailbox that no longer exists close the window and select the mailbox from the list again (mailbox card)
    “Set up your mail client” instead of the email list there's no active mailbox with a login and email download turned on: for example, only price list mailboxes click “Connect a mailbox”, or turn on email download in an existing mailbox's card (connection wizard)
    “Error: ‹text›” instead of the email body the email body is fetched from the server when opened, and the server didn't respond check access to the mailbox, then “…” → “Refresh” in the email itself (the email)
    “Email not sent!” the SMTP server rejected the send test the mailbox with “Check Connection” and read the error text (connection check)
    A template email didn't go out; the operation log says “Email not sent: no usable mailbox or required fields are empty” no mailbox is fit for sending: it needs to be active with login, password, SMTP server and sender address all at once; or the template has an empty subject, body or recipient — the parentheses say what exactly is missing complete the mailbox and make it “Default” (several mailboxes)
    An email went out from a different mailbox than expected the rule depends on where you write from: from a folder — that folder's mailbox, from a customer card — the first in the folder tree, from a template — the template's mailbox or the default set the mailbox explicitly in the template, or set the “Default” checkbox on the one you need (several mailboxes)
    The customer received the email, but it's not in your mailbox's “Sent” folder the IMAP server is empty in the mailbox card, so the app derives it from the SMTP address by replacing smtp. with imap.; for Outlook and GMX this doesn't work fill in the IMAP address and port in the mailbox card; an email already sent is in Elbuz's own “Sent” folder (mailbox card)
    “Mail synchronization is already running. Please wait until it finishes.”, and new emails don't appear while a mailbox is syncing, a new on-demand sync doesn't start. A stuck sync releases the queue after 30 minutes wait and click “Load new messages” again; if emails still don't arrive, open the mailbox card and check the server address and password (when new emails arrive)
    “Mailbox is not configured: IMAP server, login or password is empty.” one of the fields is empty in the mailbox card: “Server address” in the IMAP block, “Username” or “Password” fill in these fields in the mailbox card, or reconnect the mailbox with the wizard (mailbox card)
    A mailbox isn't in the “Mail” window, although it's in the mailbox list “Download emails to Elbuz” is off in its card: this happens with a mailbox connected from a price list card, and with an old mailbox that never downloaded any email turn the switch on in the mailbox card if you need to read its mail in Elbuz (email download)
    Older emails are missing, although they're on the mail server the first download only fetches the number of days set in “First download, days”, 90 by default raise the number or enter 0, then click “Load new messages” (email download)
    A “Mailbox disabled” notification the app failed to connect to the mailbox's IMAP server 60 times in a row and cleared “Active”. The notification goes to the account owner and the employee who owns the mailbox; it includes the reason for the last failure in the mailbox card, fix the server address or password, click “Check Connection” and turn “Active” back on. The failure counter resets on the first successful connection (connection check)

    FAQ

    Why is the connection check green, but the email wasn't sent?

    The “Check Connection” button only signs in to the mailbox on the server; it doesn't send an email. Test with a first real email to yourself (connection check).

    Why did the email go out from the wrong mailbox?

    The rule depends on where you write from: a reply — from the folder's mailbox, an email from a customer card — from the first mailbox in the folder tree, a template email — from the template's mailbox. With several mailboxes, make the main one “Default” (several mailboxes).

    I got a “Mailbox disabled” notification. After how many errors is it disabled, and how do I turn it back on?

    After 60 failed connections to the IMAP server in a row. In the mailbox card, fix the server address or password, click “Check Connection” and turn “Active” on — the first successful connection resets the counter (what to do).

    Mail on my own domain at a hosting provider — which provider do I pick in the wizard?

    The “Other” tile → “Set up manually”, plus the server values from your hosting provider (how to do it). If your domain's mail is handled by Gmail or Outlook / Office 365, pick that service's tile.

    Why didn't a new email show up while the “Mail” window was closed?

    That means the “Receiving email (IMAP)” background job is off: then emails arrive when you open a folder or click “Load new messages” in the “Additional Operations” menu. The job turns on by itself when you first connect a mailbox for reading email; it isn't listed in the “Job schedule” window (when new emails arrive).

    Why are older emails from the mailbox missing in Elbuz?

    The first download fetches emails from the last 90 days. Raise the number in the “First download, days” field in the mailbox card, or enter 0 for the full history: older emails will arrive with the next sync (email download).

    The mailbox is only for price lists. Will its emails be downloaded into the database?

    No, if you turn off “Download emails to Elbuz” in the mailbox card; the wizard in the price list card turns it off itself. The app fetches price list files directly from the mail server, so they keep arriving (what to do).

    Where to find it and who has access

    Menu
    Organizer → Mail → “Connect a mailbox”
    Other ways in
    the “Mail settings” gear → “Connect a new mailbox” or “Email users”
    List of mailboxes
    also the “Mailboxes” tile: Account → System settings → “Other settings”
    Access right
    “Mail server card” and “Mailboxes”
    Have ready
    the mailbox address and password; for eight services, an

    Without the “Mail server card” right, both opening the wizard and saving end in an access denied message. Grant mailbox rights sparingly: the card holds the mail login and password.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free