The '''Add Mail Account''' and '''Edit Mail Account''' forms let you attach an external mail account (such as Gmail, Outlook.com, Yahoo, iCloud, AOL, Fastmail, or any IMAP/SMTP server you have credentials for) to your Yioop login. Once attached, the account appears in the sidebar of the Mail activity and you can read and compose messages through it from inside Yioop.

This page is only available when the administrator has set the [[Mail_Services|Mail Services]] mode to '''External Mail Accounts''' or '''MailSite and External Mail Accounts'''.

==Provider==

A drop-down with presets for the major providers. Selecting a preset fills in the IMAP host, IMAP port, IMAP connection type, SMTP host, SMTP port, and SMTP connection type for you and hides the manual-configuration fields below. Choose '''Custom''' when none of the presets fit (a corporate mail server, a self-hosted IMAP server, or any provider not listed).

The current presets are '''Gmail''', '''Outlook.com''', '''Yahoo''', '''iCloud''', '''AOL''', and '''Fastmail'''. The preset fills hosts and ports only; you still need to enter the username (or email) and password yourself.

==Name==

A short label for this account. It appears in the sidebar account list and in the From: dropdown when composing. Pick something that helps you tell accounts apart at a glance, such as "Work Gmail" or "Personal iCloud".

==Incoming Mail (IMAP)==

These fields configure how Yioop reads messages from the source server. Shown only when the Provider is '''Custom'''; the preset providers fill them automatically and hide them.

;Host :Hostname of the IMAP server, for example '''imap.example.com'''. Do not include the protocol prefix.

;Port :TCP port the IMAP server listens on. '''993''' for implicit-TLS (IMAPS); '''143''' for cleartext or STARTTLS. Most modern providers require 993.

;Username / Email :The credential the server expects on LOGIN. Providers labelled '''Email''' want the full email address; providers labelled'''Username''' want just the local-part. For Custom configurations this label is just '''Username''' and you supply whatever the server accepts.

;Password :The IMAP password. Many providers (Gmail, Yahoo, iCloud, AOL) require an '''application password''' separate from the account password used in their web UI; consult the provider's documentation. On the Edit form the field shows a placeholder of dots when a credential is already on file; leaving the field at the dots preserves the stored credential, typing something replaces it. Passwords are encrypted at rest before being written to the Yioop database.

;Connection :TLS mode for the IMAP connection. '''IMAPS (implicit TLS)''' for port 993; '''STARTTLS''' for cleartext-then-upgrade on port 143; '''Plaintext''' is intended for testing against a server on the loopback interface and should not be used over an untrusted network.

==Outgoing Mail (SMTP)==

These fields configure how Yioop sends mail from this account. Shown only when the Provider is '''Custom'''.

;Host :Hostname of the SMTP server.

;Port :TCP port. '''465''' for implicit-TLS (SMTPS); '''587''' for STARTTLS submission; '''25''' is for server-to-server delivery and not usually appropriate for an end-user sending account.

;Username :Most providers accept the same value as the IMAP username here. Leave blank to fall back to the IMAP username.

;Password :The SMTP password. Same Edit-form behavior as the IMAP password: dots-placeholder leaves the existing credential in place; typing replaces it.

;Connection :TLS mode for outgoing SMTP. '''SMTPS''', '''STARTTLS''', or '''Plaintext''' (test-only).

==Self-signed certificates (IMAP and SMTP)==

A single checkbox that accepts self-signed or otherwise non-trusted TLS certificates on the configured IMAP and SMTP connections. Leave unchecked for any account talking to a real public provider; check only when pointing at a development or internal server with a self-signed certificate.

==Save and Cancel==

'''Save''' validates the fields and writes the row; the password is encrypted before storage. Validation surfaces errors inline next to the affected field. '''Cancel''' returns you to the Mail activity without changes; on Edit Account this also abandons any unsaved edits.

==Clone to Local Mailbox==

When the [[MailServices|Mail Services]] mode is '''MailSite and External Mail Accounts''' and you are editing an existing account, a '''Clone to Local Mailbox''' link appears under the heading. Clicking it replaces the settings form with a one-shot clone-submission form that copies messages from this external account into your local MailSite inbox. See the [[MailClone|Mail Clone]] page for details.