Sending an email in Ruby is a breeze

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

Set up with Temboo and Gmail

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 Ruby SDK and that you've added it to your development environment as described in our Ruby 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.

3Go to the Google > Gmail > SendEmail Choreo in our Library.

4Fill 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 Ruby code simpler and more secure.

Test the Choreo

5Now let's test the Google > Gmail > SendEmail Choreo directly from our website. Select Ruby from the drop down menu at the top of the page, then insert your new Profile and fill in the rest of the required inputs.

6 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 Ruby Program

7To send an email from your Ruby code, copy the generated Code from your browser directly into your Ruby class and try running it there. Your code should look something like this (but with your Profile and email address info):

require "temboo"
require "Library/Google"

class GmailHelper

    def initialize()
        # Set up your connection to Temboo.
        @session ="ACCOUNT_NAME", 

    def send_email()
        # Instantiate the Choreo, using the session instance variable.
        email_choreo =

        # Get an InputSet object for the choreo
        email_inputs = email_choreo.new_input_set()

        # Set this to the name of the Profile you created earlier.

        # Set inputs
        email_inputs.set_MessageBody("Hello, World!")
        email_inputs.set_Subject("Test from Temboo")
        # Set this to your email address.

        # Execute Choreo
        email_results = email_choreo.execute(email_inputs)


instance =

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

What next?

We're all finished! Now your Ruby application is sending email via your Gmail account. Check out what else you can do with our Ruby SDK by exploring our Library.

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.