This sample demonstrates how to use SendGrid on Google App Engine standard environment.
See the sample application documentaion for more detailed instructions.
For more information about SendGrid, see their documentation.
Before you can run or deploy the sample, you will need to do the following:
-
Sign up with SendGrid via the GCP Console and as a Google Cloud Platform developer, you can start with 12,000 free emails per month.
-
Create an API key in SendGrid and configure your SendGrid settings in the environment variables section in
appengine-web.xml
.<env-variables> <env-var name="SENDGRID_API_KEY" value="YOUR-SENDGRID-API-KEY" /> <env-var name="SENDGRID_SENDER" value="YOUR-SENDGRID-SENDER" /> </env-variables>
You can run the application locally and send emails from your local machine. You will need to set environment variables before starting your application:
export SENDGRID_API_KEY=[your-sendgrid-api-key]
export SENDGRID_SENDER=[your-sendgrid-sender-email-address]
mvn clean jetty:run
To send an email, visit localhost:8080/send/email?to=[EMAIL-ADDRESS]
in a web browser.
Deploy your application to App Engine standard with the following command:
mvn clean package appengine:deploy
To send an email, visit https://[YOUR-PROJECT-ID].appspot.com/send/email?to=[EMAIL-ADDRESS]
in a web browser.