Sending an email in Java is a breeze

Here we'll show you how to use our Java SDK to send an email via Gmail.

Get Set Up

1 Log in to Temboo. If you don't already have an account, you can register for free.

2Make sure you've downloaded the Temboo Java SDK and that you've added it to your development environment as described in our Java getting started tutorial.

3You'll also need a Gmail account, which you can create here. To authenticate with Google, you'll want to enable 2-Step Verification and generate an App Password for Temboo.

4Sign in to your Google Account settings page by clicking on your name or picture in the upper right corner of the screen and then clicking Account.

5Scroll down to the "Signing in" box.

6Click 2-Step Verification. This will bring you to the 2-Step Verification settings page.

7You will then see a step-by-step guide which will guide you through the setup process.

8After you've enabled 2-Step Verification, you'll be prompted to create an App Password.

9In the Select app dropdown menu, choose "Other", and give this app a name (e.g., TembooApp).

10Click "Generate". You'll be given a 16-digit passcode that can be used to access your Google Account from Temboo.

Note: If you wish to authenticate with OAuth credentials, you should use the Google > Gmailv2 Choreos.

11 Go to the Google > Gmail > SendEmail Choreo in our Library. Select Java from the drop down menu at the top of the page.

12Fill in your Gmail username (email address) and App-specific password, then hit the Save Profile button to save a Profile for your Gmail account. Now you can reuse your Gmail authentication details on any of our Gmail Choreos and it will also make your Java code simpler and more secure.

Test the Choreo

13Now let's test the Google > Gmail > SendEmail Choreo directly from our website. Insert your new Profile and fill in the rest of the required inputs.

14 Click Generate Code to test the Choreo from our website, and you'll see the value "true" for the Success output in the Output section. Assuming you emailed yourself, you can go to your inbox and see the email appear!

Create Your Java Program

15To send an email from your Java code, copy the generated code from your browser directly into your Java class and try running it there. Your code should look something like this:

import com.temboo.Library.Google.Gmail.SendEmail;
import com.temboo.Library.Google.Gmail.SendEmail.SendEmailInputSet;
import com.temboo.Library.Google.Gmail.SendEmail.SendEmailResultSet;
import com.temboo.core.TembooSession;

public class GmailHelper {	

	public static void main(String[] args) throws Exception {

		// Create a new Temboo session.
		TembooSession session = new TembooSession("ACCOUNT_NAME", "APP_NAME", "APP_KEY");

		// Instantiate the Google.Gmail.SendEmail Choreo, using the session object.
		SendEmail sendEmailChoreo = new SendEmail(session);

		// Get an InputSet object for Google.Gmail.SendEmail Choreo.
		SendEmailInputSet sendEmailInputs = sendEmailChoreo.newInputSet();

		// Set Profile to use for execution. Note this value should be the name of the Profile that you created earlier.

		// Set inputs for Google.Gmail.SendEmail Choreo.
		sendEmailInputs.set_MessageBody("Hello world!");
		sendEmailInputs.set_Subject("Test from Temboo");

		// Execute Google.Gmail.SendEmail Choreo
		SendEmailResultSet sendEmailResults = sendEmailChoreo.execute(sendEmailInputs);

		// Print status


16Run the code and check your inbox - your email should be waiting.

What next?

We're all finished! Now your Java application is sending email via your Gmail account. Why not check out the rest of the 2000+ Choreos in our Library and think about how you could extend this example by combining it with something else.

Once you've got your code up and running, you're ready to move on and do more. From monitoring your running applications, to moving your generated Temboo code to your preferred development environment and sharing it with colleagues, collaborators and friends - we've got you covered.

Need help?

We're always happy to help. Just email us at, and we'll answer your questions.