# User Email: Setup and Usage

Setting up emails in the system is essential to foster seamless communication and sharing of information. From dispatching order confirmations to issuing payment reminders, the setup of emails plays an important role in ensuring the seamless functioning of a business.

In XoroERP, there are two types of email configurations: Company Email and User Email. Company emails serve as the official communication channel for the organization, while user emails are specific to the individual users of the system.

### Which types of emails are sent using the User Email?

User email is used to send manual emails from the system for more personalized communication. The emails added to “**Add to Email Queue** ” are sent via user email.&#x20;

The user email is used to send various documents and notifications from the system, including:

* Sales orders
* Purchase orders
* Invoices
* Item receipts
* Payment reminders
* Order confirmations

### Setting up the emails

The process for **setting up the User Email**  involves selecting the service type to configure the email, (**Webmail (Microsoft), Exchange, or Email Services)** and then setting up the details of the selected type.

{% hint style="info" %}
To set up the User Email, go to **Menu > User > User Email Setup**
{% endhint %}

In the email configuration page, select the email service type to begin the process.

<figure><img src="/files/PzznX48lVQluFHX52wsx" alt=""><figcaption></figcaption></figure>

<details>

<summary>WebMail Email Services Setup</summary>

**To set up the “Web Mail” Email Services** follow the steps below:

* Enter the Outgoing Mail Server(SMTP): **smtp.office365.com- for Microsoft & smtp.gmail.com- for Gmail.**
* Enter the Email Address.
* Port Number–>587
* Enable SSL, and
* Email Password
* Click Validate to verify the information you entered is correct.
* Once validated, click Save.<br>

  <figure><img src="/files/lhXSo0IwlnFLXMDttEZv" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Exchange Services Setup</summary>

For the Email Service Type **Exchange**, **fill in the following details:**

* Fill in the “**Domain**“, “**Username**“, and the “**Email Password**“.
* **Exchange Uri**: <https://outlook.office365.com/EWS/Exchange.asmx>
* Click "Validate" to verify the information you entered is correct.
* Once validated, click Save.<br>

  <figure><img src="/files/oARpKjmfFHFj4i6TqDJL" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Email Services Setup</summary>

To setup the “Gmail” Services follow the steps below:

* Select Email Service Type: **Email services**.
* Then click on “**Connect**” in the Add Service.

  <figure><img src="/files/uUOyY41MgPGcGre8pDql" alt=""><figcaption></figcaption></figure>
* Sign in with **Google Account**.
* Then click on the “**Allow**“. (This will activate the email Services in the Xoro).

</details>

### Common Issues in Email Setup and Suggested Resolutions

1\. **Getting the error “Cannot complete the request. Cannot send a test mail**. The SMTP server required a secure connection or the client was not authenticated. The server response was: 5.7.1 Authentication Required. Learn more at. Please try again.” while validating. This message typically appears if the email or password or both are incorrect. Please re-check them all.

This message can also appear if you use Gmail and Google is blocking the sign-in attempts due to Security Standards. In that case, you will need to generate App Password for your Gmail Account to validate the Email. Here’s how:

* Click on the Google icon.

  <div align="left"><figure><img src="/files/Ggf5CRs5Sd9hBSAqwwab" alt=""><figcaption></figcaption></figure></div>
* Then, click on “Manage your Google Account”.

  <div align="left"><figure><img src="/files/v9RbM3x71SfwBwWynIVm" alt=""><figcaption></figcaption></figure></div>
* Click on the “Security” tab.

  <figure><img src="/files/ST9dJ4z1Mz8PIjAqm0Nv" alt=""><figcaption></figcaption></figure>
* Under the “Signing in to Google” section, make sure the 2-Step Verification is turned On. If it is not, then turn it on.

  <figure><img src="/files/LGqUIcxWyAtbUhuq5iyW" alt=""><figcaption></figcaption></figure>
* After turning on the 2-Step Verification, go back to the “Security” tab and click on “2-Step Verification”.

  <figure><img src="/files/aoGhdI8rheMnK77gKtis" alt=""><figcaption></figcaption></figure>
* Enter your Google Account Password for Validation, if prompted, and click on “Next”.![](/files/JdJLpJlFo1CLzHuKZzTV)
* In the “2-Step Verification” page, scroll down to the bottom and click on the “App Passwords” option.

  <div align="left"><figure><img src="/files/aGVWK9e1DFdnxUkSUf5x" alt=""><figcaption></figcaption></figure></div>
* Here, select “Other (Custom Name)” from the dropdown options.

  <div align="left"><figure><img src="/files/TeISVIDihlnAWPM1KIDW" alt=""><figcaption></figcaption></figure></div>
* Enter “Xorosoft” and click “Generate”.

  <figure><img src="/files/OEsoRVbADbC9KXR3Vmmz" alt=""><figcaption></figcaption></figure>
* A 16-digit App Password will be generated for your device. This password grants complete access to your Google Account.

  <div align="left"><figure><img src="/files/nHKjVJPhKAnv9KeUODjw" alt=""><figcaption></figcaption></figure></div>
* Copy this Password and paste this into Xoro’s “Email Password” field on the Email Configuration Setup page.

  <div align="left"><figure><img src="/files/sLnmvmoLuqhof03tnst5" alt=""><figcaption></figcaption></figure></div>
* Save the changes and Validate the Email.

  <div align="left"><figure><img src="/files/D2ghZy7aR8tsKNQwgcyO" alt=""><figcaption></figcaption></figure></div>

*\*\*Please note that it is mandatory to enable 2-Step Verification to be able to use this feature.*

2\. **Getting the error “Cannot complete the request. Cannot send a test mail. Failure sending mail. Please try again” while validating.** This typically appears if the outgoing mail server or port number or both are incorrect. Please re-check them all.

3\. **Getting the error “Cannot complete the request. Cannot test mail. The SMTP server requires a secure connection or the client was not authenticated.”** This typically appears if the SSL setting is incorrect. Please re-check this.

4\. If you are using Exchange Service type then the domain should be in the format of “company.com” (without quotes).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xorosoft.com/xoroerp-1/user/user-email-setup/user-email-setup-and-usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
