Code Generation for APIs
Program the world. Generate code in less than 10 minutes.
This feature isn't available on your account.
Want to account?
Back to Kosmos

Choreos

Public
Private

You have no favorites... yet!

Your Private APIs Here

Enable digital transformation at your organization.

Learn More
  • A0
  • A1
  • A2
  • A3
  • A4
  • A5
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
Get started with Bluetooth
Arduino
Texas Instruments
Samsung
C#
Java
JavaScript
Node.js
PHP
Processing
Python
REST API
Ruby
iOS
Android
Onboard Ethernet & WiFi
with
Switch Choreo

Choose your Edge Device

Pick a Choreo for your Gateway Device

Use the Library tree on the left to select a Choreo to call from your gateway device.

Pick a Choreo for your Edge Device

Use the Library tree on the left to select a Choreo to call from your edge device via the gateway.

Choreo Trigger
If at is
High Low
then trigger

Library . Google . Gmailv2 . Threads . GetThread

Retrieves an individual thread from a user's mailbox.

  • Input
    • ClientID The Client ID provided by Google. Required unless providing a valid AccessToken.
    • ClientSecret The Client Secret provided by Google. Required unless providing a valid AccessToken.
    • RefreshToken An OAuth Refresh Token used to generate a new Access Token when the original token is expired. Required unless providing a valid AccessToken.
    • ThreadID The ID of the thread to retrieve.
  • Optional Input
    • AccessToken A valid Access Token retrieved during the OAuth2 process. This is required unless you provide the ClientID, ClientSecret, and RefreshToken to generate a new Access Token.
    • Fields Used to specify fields to include in a partial response. This can be used to reduce the amount of data returned. See Choreo notes for syntax rules.
    • UserID The ID of the acting user. Defaults to "me" indicating the user associated with the Access Token or Refresh Token provided.
  • Output
    Actuator Trigger Condition
    If{"NewAccessToken":{"type":"string","description":"Contains a new AccessToken when the RefreshToken is provided."},"Response":{"type":"json","description":"The response from Google."},"Success":{"type":"boolean"}} then write
    High Low
    to at
    • NewAccessToken Contains a new AccessToken when the RefreshToken is provided.
    • Response The response from Google.
  • CHOREO CLASS 
    • /*
TembooTask class placeholder
*/
  • iOS HEADER 
    • /*
TembooTask header placeholder
*/
    • Simple
    • Enhanced
      Add a sensor via the virtual pin board above to generate code for sensor data graphs.
    • Compiled
      Add a sensor or actuator via the virtual pin board above to generate compiled code for sensor data graphs and remote actuator control.
    Device Configure Changed

    Since you've changed your device configuration, you'll need to tell us about this new device.

    1. Add a sensor or actuator to your device.
    2. Register your board and download your code.

    OK! Let's set up your device

    This feature is in experimental mode - pricing coming soon.

    Use lat/long
    Pro Tip!
    Power consumption will increase if you choose a higher frequency.
    Safeguard data
    what's this?
    If connectivity is lost, up to 2MB of data will be stored locally on your device, and updated when connectivity is restored.

    Commit your generated code
    and collaborate with others.

    Send your code straight to a GitHub repository.

    Collaborating on GitHub?

    Your code will be visible by others in your repos. Keep credentials private by saving a Profile or commit code with Placeholder inputs.

    Choose a GitHub Repository

    Name:

    The following files will be added to this repo:

    * Don't worry! Your credentials and any inputs that aren't saved in a Profile will not be included.

    Success!

    Visit the link below to view, modify, and share code.

    Commit code to GitHub

    Send code to CCS Cloud.

    You'll be able to edit and share your code from TI's CCS Cloud IDE.

    Name your application

    Names can only contain letters, numbers, hyphens, and underscores.

    The following will be sent to CCS Cloud:

    TembooMain.c
    TembooAccount.h
    instructions.txt
    + 9 others

    Success!

    Visit the link below to view, modify, and share code.

    https://dev.ti.com/ide/
    Code 
    • // Instantiate the Choreo, using a previously instantiated TembooSession object, eg:
// TembooSession session = new TembooSession("accountName", "myFirstApp", "abc123xxxxxxxxxxxxxx");

GetThread getThreadChoreo = new GetThread(session);

// Get an InputSet object for the choreo
GetThreadInputSet getThreadInputs = getThreadChoreo.newInputSet();

// Set inputs

// Execute Choreo
GetThreadResultSet getThreadResults = getThreadChoreo.execute(getThreadInputs);
  • Header File 
    • /* 
A header file containing your Temboo account information will appear here once you've
configured your device above.
*/
  • Proxy Code 
    • /*
Please log in to generate proxy server code for use with the JavaScript SDK.
*/
  • Notes

    • This Choreo retrieves an individual thread from a user's mailbox. The documentation for this Gmail resource can be found here.

      Note: this method requires that you request one of the following scopes during the OAuth process:

      https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly

      The Fields input can be used to reduce the number of fields returned in the response. The syntax for using this parameter is loosely based on XPath. Below are some points to remember when using this input:

      • Fields should be separated by commas.
      • When fields are nested within other fields, you can refer to them using a path (i.e. urls/value).
      • Specify field sub-selectors to request only specific sub-fields by using parentheses "( )" after any selected field.

      Here is an example of acceptable inputs:

      ClientID: {YOUR CLIENT ID}
      ClientSecret: {YOUR CLIENT SECRET}
      RefreshToken: {YOUR REFRESH TOKEN}
      ThreadID: 1475ada1f4ba86ba

      The following is a sample of the JSON information returned by this Choreo:

      {
 "id": "1475ada1f4ba86ba",
 "historyId": "3838093",
 "messages": [
  {
   "id": "1475ada1f4ba86ba",
   "threadId": "1475ada1f4ba86ba",
   "labelIds": [
    "SENT",
    "INBOX"
   ],
   "snippet": "foo",
   "historyId": "3838026",
   "payload": {
    "mimeType": "multipart/alternative",
    "filename": "",
    "headers": [
     {
      "name": "MIME-Version",
      "value": "1.0"
     },
     {
      "name": "Received",
      "value": "by 10.140.27.162 with HTTP; Mon, 21 Jul 2014 14:35:49 -0700 (PDT)"
     },
     {
      "name": "Date",
      "value": "Mon, 21 Jul 2014 17:35:49 -0400"
     },
     {
      "name": "Delivered-To",
      "value": "aaron.jennings@temboo.com"
     },
     {
      "name": "Message-ID",
      "value": "\u003cCAEqmo68ESRzXn3LTzOs0AQAbjk3aamesfWtsVxnbD0ugr_qxrg@mail.gmail.com\u003e"
     },
     {
      "name": "Subject",
      "value": "test thread"
     },
     {
      "name": "From",
      "value": "Aaron Jennings \u003caaron.jennings@temboo.com\u003e"
     },
     {
      "name": "To",
      "value": "Aaron Jennings \u003caaron.jennings@temboo.com\u003e"
     },
     {
      "name": "Content-Type",
      "value": "multipart/alternative; boundary=001a113525d2063b6804febae4f6"
     }
    ],
    "body": {
     "size": 0
    },
    "parts": [
     {
      "partId": "0",
      "mimeType": "text/plain",
      "filename": "",
      "headers": [
       {
        "name": "Content-Type",
        "value": "text/plain; charset=UTF-8"
       }
      ],
      "body": {
       "size": 5,
       "data": "Zm9vDQo="
      }
     },
     {
      "partId": "1",
      "mimeType": "text/html",
      "filename": "",
      "headers": [
       {
        "name": "Content-Type",
        "value": "text/html; charset=UTF-8"
       }
      ],
      "body": {
       "size": 28,
       "data": "PGRpdiBkaXI9Imx0ciI-Zm9vDQo8L2Rpdj4NCg=="
      }
     }
    ]
   },
   "sizeEstimate": 674
  },
  {
   "id": "1475ada4d55729b8",
   "threadId": "1475ada1f4ba86ba",
   "labelIds": [
    "SENT",
    "INBOX",
    "UNREAD"
   ],
   "snippet": "bar On Mon, Jul 21, 2014 at 5:35 PM, Aaron Jennings <aaron.jennings@temboo.com> wrote: foo --",
   "historyId": "3838071",
   "payload": {
    "mimeType": "multipart/alternative",
    "filename": "",
    "headers": [
     {
      "name": "MIME-Version",
      "value": "1.0"
     },
     {
      "name": "Received",
      "value": "by 10.140.27.162 with HTTP; Mon, 21 Jul 2014 14:36:01 -0700 (PDT)"
     },
     {
      "name": "In-Reply-To",
      "value": "\u003cCAEqmo68ESRzXn3LTzOs0AQAbjk3aamesfWtsVxnbD0ugr_qxrg@mail.gmail.com\u003e"
     },
     {
      "name": "References",
      "value": "\u003cCAEqmo68ESRzXn3LTzOs0AQAbjk3aamesfWtsVxnbD0ugr_qxrg@mail.gmail.com\u003e"
     },
     {
      "name": "Date",
      "value": "Mon, 21 Jul 2014 17:36:01 -0400"
     },
     {
      "name": "Delivered-To",
      "value": "aaron.jennings@temboo.com"
     },
     {
      "name": "Message-ID",
      "value": "\u003cCAEqmo68mGro4kz+AO9Kgp4JkRHEx23naoUZQ55cjK-7vCJ-i=A@mail.gmail.com\u003e"
     },
     {
      "name": "Subject",
      "value": "Re: test thread"
     },
     {
      "name": "From",
      "value": "Aaron Jennings \u003caaron.jennings@temboo.com\u003e"
     },
     {
      "name": "To",
      "value": "Aaron Jennings \u003caaron.jennings@temboo.com\u003e"
     },
     {
      "name": "Content-Type",
      "value": "multipart/alternative; boundary=20cf3074b02cbfcb0404febae425"
     }
    ],
    "body": {
     "size": 0
    },
    "parts": [
     {
      "partId": "0",
      "mimeType": "text/plain",
      "filename": "",
      "headers": [
       {
        "name": "Content-Type",
        "value": "text/plain; charset=UTF-8"
       }
      ],
      "body": {
       "size": 185,
       "data": "YmFyDQoNCg0KT24gTW9uLCBKdWwgMjEsIDIwMTQgYXQgNTozNSBQTSwgQWFyb24gSmVubmluZ3MgPGFhcm9uLmplbm5pbmdzQHRlbWJvby5jb20-DQp3cm90ZToNCg0KPiBmb28NCj4NCg0KDQoNCi0tIA0KQWFyb24gSmVubmluZ3MgfCBUZW1ib28gfCAxMDQgRnJhbmtsaW4gU3RyZWV0IE5ZQyB8IHd3dy50ZW1ib28uY29tDQo="
      }
     },
     {
      "partId": "1",
      "mimeType": "text/html",
      "filename": "",
      "headers": [
       {
        "name": "Content-Type",
        "value": "text/html; charset=UTF-8"
       },
       {
        "name": "Content-Transfer-Encoding",
        "value": "quoted-printable"
       }
      ],
      "body": {
       "size": 640,
       "data": "PGRpdiBkaXI9Imx0ciI-YmFyPC9kaXY-PGRpdiBjbGFzcz0iZ21haWxfZXh0cmEiPjxicj48YnI-PGRpdiBjbGFzcz0iZ21haWxfcXVvdGUiPk9uIE1vbiwgSnVsIDIxLCAyMDE0IGF0IDU6MzUgUE0sIEFhcm9uIEplbm5pbmdzIDxzcGFuIGRpcj0ibHRyIj4mbHQ7PGEgaHJlZj0ibWFpbHRvOmFhcm9uLmplbm5pbmdzQHRlbWJvby5jb20iIHRhcmdldD0iX2JsYW5rIj5hYXJvbi5qZW5uaW5nc0B0ZW1ib28uY29tPC9hPiZndDs8L3NwYW4-IHdyb3RlOjxicj4NCjxibG9ja3F1b3RlIGNsYXNzPSJnbWFpbF9xdW90ZSIgc3R5bGU9Im1hcmdpbjowIDAgMCAuOGV4O2JvcmRlci1sZWZ0OjFweCAjY2NjIHNvbGlkO3BhZGRpbmctbGVmdDoxZXgiPjxkaXYgZGlyPSJsdHIiPmZvbw0KPC9kaXY-DQo8L2Jsb2NrcXVvdGU-PC9kaXY-PGJyPjxiciBjbGVhcj0iYWxsIj48ZGl2Pjxicj48L2Rpdj4tLSA8YnI-PGRpdiBkaXI9Imx0ciI-QWFyb24gSmVubmluZ3MgfMKgVGVtYm9vIHwgMTA0IEZyYW5rbGluIFN0cmVldCBOWUMgfMKgPGEgaHJlZj0iaHR0cDovL3d3dy50ZW1ib28uY29tLyIgc3R5bGU9ImNvbG9yOnJnYigxNyw4NSwyMDQpIiB0YXJnZXQ9Il9ibGFuayI-d3d3LnRlbWJvby5jb208L2E-PGJyPg0KPC9kaXY-DQo8L2Rpdj4NCg=="
      }
     }
    ]
   },
   "sizeEstimate": 1737
  }
 ]
}
Getting Started
  1. Select Your Board
    Select the dev board you want to generate code for.
  2. How Is It Connected?
    Tell us how your board connects to the internet.
  3. Set Up Your Sensors
    Sense anything. Choose predefined sensors or select other to set up a generic sensor that reads pin voltage.
  4. Set a Choreo Trigger
    Use conditional logic to trigger Temboo Choreos based on sensor values.
  5. Set Up Your Actuators
    Choose pre-defined actuators for real-world actions, or select generic actuators to output raw data.
  6. Obtain Your Credentials
    Turn on 2-step authentication on your Google account, and then create an application-specific password using these Setup Instructions.
    Security Tip
    We recommend keeping important credentials out of your code by storing them using Profiles. This also reduces memory consumption and makes it easy to update them without changing your code.
  7. Obtain Your Credentials
    You’ll need to go through the OAuth process to obtain proper credentials which Temboo has simplified with Choreos. We recommend checking out this video before getting started with OAuth.
    Security Tip
    We recommend keeping important credentials out of your code by storing them on Temboo. This also reduces memory consumption and makes it easy to update them without changing your code.
  8. Obtain Your Credentials
    You’ll need to go through the OAuth process to obtain proper credentials which Temboo has simplified with Choreos. We recommend checking out this video before getting started with OAuth.
    Security Tip
    We recommend keeping important credentials out of your code by storing them on Temboo. This also reduces memory consumption and makes it easy to update them without changing your code.
  9. Obtain Your Credentials
    Create a Twilio account and obtain your AccountSID and authorization token by looking at your Dashboard (see our full setup instructions ).
    Security Tip
    We recommend keeping important credentials out of your code by storing them on Temboo. This also reduces memory consumption and makes it easy to update them without changing your code.
  10. Obtain Your Credentials
    Create a Nexmo account and obtain your API Key and API Secret in the API Settings menu API Settings menu (see our full setup instructions ).
    Security Tip
    We recommend keeping important credentials out of your code by storing them on Temboo. This also reduces memory consumption and makes it easy to update them without changing your code.
  11. Supply Some Inputs
    Give the process an input value e.g., "New York City".

    You'll find notes for valid inputs by scrolling to the bottom of the page.
  12. Supply Some Inputs
    Fill in the desired Subject, FromAddress, ToAddress, and MessageBody.
  13. Supply Some Inputs
    Fill in the desired From, Subject, To, and MessageBody.
  14. Supply Some Inputs
    Fill in the desired Values and SpreadsheetID.
  15. Supply Some Inputs
    Fill in the desired From, To and Body.
  16. Supply Some Inputs
    Fill in the Text input with “Press 1 to change the state of your pin”. This is the message that will be translated to speech in the phone call alert. Fill in the desired ByeText, To, and Body. Set MaxDigits to 1.
  17. Test your inputs in the browser
    Click 'Generate Code' to test that your inputs are valid.
  18. Set an Output Trigger
    Set a condition based on your actuator values if your Yun should call based on an output.
  19. Select Your Language
    Select from the list of boards that come pre-shipped with Temboo's libraries.
  20. Voila! Your Code Is Ready
    Download your code and you’re ready to run.
    21. Google requires that you enable 2-step verification and generate an App password to use this Choreo. If you’d like to authenticate using OAuth credentials, you should use the Google.Gmailv2 Choreos.
  21. Obtain Your Client ID
    We recommend checking out this video before getting started with OAuth.

    Log in to Google's Developer Console, and create a new Project if you haven't done so already.

    In the Google API Manager, search for the API you'd like to enable and click Enable.

    Go to the credentials tab and create a new Client ID and specify Web Browser for the Application Type.

    Save the Consent screen details. Specify this callback URL as the Authorized Redirect URI:

    https://ACCOUNT_NAME.temboolive.com/callback/google


    Plug in the Client ID you've generated into the first input.
  22. Specify Required Scopes
    Specify any scopes your application requires. Scroll to the Notes section at the bottom of the Choreo page to find the scopes available for Google APIs in the Temboo library.
  23. Test Your Inputs
    Click the 'Generate Code' button to generate your Authorization URL and Callback ID.
  24. Visit the Authorization URL
    Open a new web browser tab, navigate to the authorization URL returned by the InitializeOAuth Choreo, and click "Accept" to grant the app access to your Google account.
  25. Run the Finalize Choreo
    Use the new credentials you've just generated in the FinalizeOAuth Choreo.
  26. Obtain Credentials
    Obtain your credentials by following the instructions in the InitializeOAuth Choreo page.

    Use the CallbackID generated during the InitializeOAuth process as an input here.
  27. Test Your Inputs
    Click the 'Generate Code' button to generate your Refresh Token.
  28. Copy the Refresh Token
    You'll need the Refresh Token, Client ID, and Client Secret to run the Google Choreo you're working with.
  29. Use Your Credentials
    Use the Refresh Token along with the Client ID and Client Secret to authenticate with Google for the Google Choreo you're interested in.
    30. Need help getting started?
    Get in touch.
Run Your Code
  • Install the Arduino IDE
    Make sure you've got the latest version of the Arduino IDE - it comes with the Temboo library already installed.
  • Upgrade The Temboo Library
    Use the Library Manager in the Arduino IDE to make sure you have the latest version of the Temboo library.
  • Connect to the internet
    Confirm that your Arduino board is connected to the internet.
    Security Tip
    Protect your device from malicious attacks. Change its default name and password before connecting it to the internet.
  • Run the sketch
    Open your auto-generated code in the Arduino IDE and upload it to your board. You can use the serial monitor to see your board connecting to Temboo.
What's Next?
Arduino + Temboo
  • Install the Energia IDE
    Make sure you've got the latest version of the Energia IDE - it comes with the Temboo library already installed.
  • Connect to the internet
    Confirm that your LaunchPad is connected to the internet.
  • Run the sketch
    Open Energia and make sure you've got the correct board selected in the "Tools > Board" menu. Upload the code to your board and use the serial monitor to see your board connecting to Temboo.
What's Next?
TI + Temboo
  • Run CCS Cloud
    Placeholder
What's Next?
TI + Temboo
  • Run Your ARTIK Code
    You can find full instructions for running Temboo code on the Samsung ARTIK in this tutorial.
What's Next?
Samsung ARTIK + Temboo
  • Run Your iOS Code
    You can find full instructions for running Temboo iOS code in this tutorial.
What's Next?
iOS + Temboo
  • Run Your Node.js Code
    You can find full instructions for running Temboo Node.js code in this tutorial.
What's Next?
Node.js + Temboo
  • Run Your PHP Code
    You can find full instructions for running Temboo PHP code in this tutorial.
What's Next?
PHP + Temboo
  • Run Your Processing Code
    You can find full instructions for running Temboo Processing code in this tutorial.
What's Next?
Processing + Temboo
  • Run Your Python Code
    You can find full instructions for running Temboo Python code in this tutorial.
What's Next?
Python + Temboo
  • Run Your Ruby Code
    You can find full instructions for running Temboo Ruby code in this tutorial.
What's Next?
Ruby + Temboo
  • Run Your C# Code
    You can find full instructions for running Temboo C# code in this tutorial.
What's Next?
C# + Temboo
  • Run Your JavaScript Code
    You can find full instructions for running Temboo JavaScript code in this tutorial.
What's Next?
JavaScript + Temboo
  • Run Your cURL Request
    Copy the cURL snippet and run it from a terminal window - that's it!
What's Next?
Learn Temboo's REST API
  • Run Your Java Code
    You can find full instructions for running Temboo Java code in this tutorial.
What's Next?
Java + Temboo
  • Run Your Android Code
    You can find full instructions for running Temboo Android code in this tutorial.
What's Next?
Android + Temboo
Please select a platform to see instructions to run your code.
  • Run InitializeOAuth
    Have your application run the InitializeOAuth Choreo to generate the Authorization URL.
  • Have the user authorize access
    Using a web browser, direct the user to the Authorization URL provided in the InitializeOAuth step and have them manually grant access to your application.
  • Run FinalizeOAuth
    Once control has been returned to your application, run the FinalizeOAuth Choreo to generate your access tokens.
Welcome to Temboo
Program the world. Generate code in less than 10 minutes.
What type of code would you like to generate?
Arduino
Texas Instruments
Samsung
C#
Java
JavaScript
Node.js
PHP
Processing
Python
REST API
Ruby
iOS
Android