Where
Integrations→Integrations→Email Accounts
Your role needs
Read access to Email Accounts
read-senders. Admin, Member and Viewer have it by default.To create or change
create-senders to add one, update-senders to change one, on top of the permission above.If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.
Before you begin
- The six connection values from your provider: host, port and security type for sending (SMTP), and the same three for receiving (IMAP). The Other (any) tile carries no preset, so none of them are filled in for you.
- The password you sign in to that mailbox with.
- A port we accept. Sending must use 465, 587 or 25, and receiving must use 993 or 43. A mailbox on any other port is refused before a connection is attempted.
- IMAP switched on for the mailbox. Sending is only half the check.
Connect the mailbox
1
Open the provider list
Go to and choose
Add senders. On the panel, choose Connect your email.Gmail and Outlook lead as their own cards. Everything else sits in the All providers
grid below them. Choose Other (any): the tile with an inbox icon instead of a logo, and
the only one that arrives with no server settings behind it.
2
Enter your account details
The wizard opens on Your account. Put the mailbox address in Email address, and
the name recipients should see in Sender name; the name on your own account is filled
in there already, so change it only if you want something else. The helper under the field
says where it ends up: shown as the “From” name on your emails. Choose Continue.
3
Enter the mailbox password
The next screen asks for Email password: the one you use to sign in to this mailbox.
Other (any) has no app-password step, unlike the tiles for providers we know require one.
If yours issues app-specific passwords, generate the code there and paste that instead.
Choose Continue.
4
Fill in the server settings by hand
Because the tile has no preset, Server settings always appears. Fill in SMTP host,
SMTP port and SMTP security for sending, then IMAP host, IMAP port and
IMAP security for reading replies. The screen says where to find them: your provider’s
help pages, usually under “SMTP and IMAP settings”. All six are required: the button
below them stays disabled, and says why, until every one is filled.SMTP port accepts 465, 587 or 25, and IMAP port accepts 993 or 43. Both security
fields offer SSL, TLS and None.
Port and security are not one switch. When we test the connection we work the security
out from the port you entered: 465 as SSL, 587 as TLS, 25 as none for sending, and 993
as TLS, 43 as none for receiving. So an unusual pairing is not what actually gets
tested. The account is then saved with the types you chose, and those are what it sends
with: for sending we open an encrypted connection up front only when SMTP security
is SSL, while for receiving we do it for anything other than None. Use the pairing your
provider documents and the two never disagree.
5
Verify the connection
Choose Verify connection. We open a real connection to the mailbox for sending and for
receiving, because a mailbox that can send but never receive would never show you a reply.
A successful check saves the account for you. There is no separate save step.When the check cannot reach the server, or fails for a reason it does not recognise, it
offers the usual port-and-security pairings as one-click chips: 465 with SSL, 587 with
TLS, leaving out whichever pair you already have. Choosing one changes the setting and
retries straight away.
What happens next
A panel reads “Your email is connected” with the mailbox address under it. Choose Done,
and the mailbox is on the Email Accounts page.
Troubleshooting
That password didn't work
That password didn't work
Your provider rejected this address and password together, so check both. Choose
Re-enter password to go back to the field. Nothing you typed is lost.A partly copied password fails exactly like a wrong one. If your provider issues
app-specific passwords, the screen’s own advice is to generate a fresh one and paste that.
We couldn't read this inbox (IMAP)
We couldn't read this inbox (IMAP)
Sending only works when we can also read replies, and the receiving side of the check
failed. The screen walks you through the usual cause: open your mailbox settings at your
provider, find the IMAP section (sometimes labelled “external access”) and turn it on,
then come back and choose Try again. If IMAP is already on, check the receiving host
and port before retrying.
Connection error. Check your Email Settings.
Connection error. Check your Email Settings.
This is the failure you get from the account’s own form rather than the wizard, after
Check Connection. The message names each side that refused (SMTP, IMAP or both) and
quotes the reason that server gave back, so you can fix the fields in place and re-test
without recreating the account. A request that fails outright, rather than coming back
with a result, shows that error’s own message instead.
Related
Add senders
Connect, import a CSV, or order managed infrastructure: how to choose between them.
Sender settings
Every field in the account form, including the schedule this wizard does not create.
Reconnect an email account
What Reconnect actually does, and every Error message explained.
Error messages glossary
Every user-visible error string, in one alphabetical list, each pointing at the page that
explains it.