Email Sender

Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. Contact
7. Acknowledgements

About The Project

It is a REST API that will extract emails data from excel file and send those emails with provided email.

Built With

• Spring
• Maven
• GMail

Getting Started

Prerequisites

Install maven from maven site Installing Maven

• mvn

  mvn -version
  Apache Maven 3.6.0 (97c98ec64a1fdfee7767ce5ffb20918da4f719f3; 2018-10-25T00:11:47+05:30)

Installation

1. Clone the repo

   git clone https://github.com/pvyas033/EmailSender.git

2. Run below command

   mvnw spring-boot:run

Usage

The usage may be differe with front end. Here I will explain how you can test this with Postman.

1. Download Postman if you don't have Download.

2. Start server by typing below commands:

   mvnw spring-boot:run

3. Once server is up and running make a POST request from Postman to send sender information like below

   

4. Then make POST request for uploading excel file that contain email information

   

   That excel file will be like below Test.excel

   

5. Then make GET request for send emails and you will see it will send all email that you have added in excel file with your sender information.

   

Note: If you receive any error like below then please follow mention steps:

Error:

JavaMail Exception javax.mail.AuthenticationFailedException 534-5.7.9 Application-specific password required

Reason: You have enabled Two phase authentication for your Google account and as a result applications will not be able to login to your Google account using the actual password. Google expects you to generate a application specific password for each application you use (and give it a name) and then use that password to login to your Google account from your application. This allows you to not give your password to third party application when you have 2-step authentication enabled.

Solution: Just create an App Password for your account and use that password.

Steps to create password:

Go to your account settings (https://myaccount.google.com/) -->> Security -->> Under signing in to Google -->> App Password -->> Enter your credentials to login to your account -->> Select 'App' and 'Device' -->> Generate.

Copy and paste the password somewhere.

You can use this password instead of your account password.

Roadmap

I'll make frontend application to complete this email sender interface.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contact

Pankaj Vyas | Website | LinkedIn | Twitter | [email protected]

Email Sender - https://github.com/pvyas033/EmailSender

Acknowledgements

• Spring Boot