Sample code for 30+ languages & platforms
Android™

Outlook Send Email using MIME Format

See more Outlook Examples

This example sends an email using MIME format via the Microsoft Graph Outlook REST API.

Chilkat Android™ Downloads

Android™
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkHttp http = new CkHttp();

    // Use your previously obtained access token here:
    // See the following examples for getting an access token:
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
    //    Refresh Access Token (Azure AD v2.0 Endpoint).
    //    Refresh Access Token (Azure AD Endpoint).

    CkJsonObject jsonToken = new CkJsonObject();
    success = jsonToken.LoadFile("qa_data/tokens/microsoftGraph.json");
    if (success == false) {
        Log.i(TAG, jsonToken.lastErrorText());
        return;
        }

    http.put_AuthToken(jsonToken.stringOf("access_token"));

    // To send email, we'll POST to the following endpoint:
    // 
    // POST /users/{id | userPrincipalName}/sendMail
    // 
    // (The special keyword "me" may be used in place of a principal name.)
    // 

    // The body of the POST request will contain the MIME source of the email in base64 format.

    // Create a new email object
    CkEmail email = new CkEmail();
    email.put_Subject("Test Outlook API to Send HTML Email with Attachments");
    email.put_From("Mary <mary@somewhere.com>");
    email.AddTo("Joe","joe@example.com");

    // Add a plain-text alternative body, which will likely never be seen.
    // (It is shown if the receiving email client is incapable of displaying HTML email.)
    email.AddPlainTextAlternativeBody("This is a plain-text alternative body...");

    // Our HTML will include an image, so add the related image here.
    String contentIdStarfish = email.addRelatedFile("qa_data/jpg/starfish.jpg");
    if (email.get_LastMethodSuccess() == false) {
        Log.i(TAG, email.lastErrorText());
        return;
        }

    // The src attribute for the image tag is set to the contentIdStarfish:
    CkStringBuilder sbHtml = new CkStringBuilder();
    sbHtml.Append("<html><body><p>This is an HTML email with an embedded image.</p>");
    sbHtml.Append("<p><img src=\"cid:CONTENT_ID_STARFISH\" /></p></body></html>");
    int numReplacements = sbHtml.Replace("CONTENT_ID_STARFISH",contentIdStarfish);

    email.AddHtmlAlternativeBody(sbHtml.getAsString());

    // Finally, add some attachments to the email.
    // Add a file attachment.
    success = email.AddFileAttachment2("qa_data/pdf/fishing.pdf","application/pdf");
    if (success == false) {
        Log.i(TAG, email.lastErrorText());
        return;
        }

    // Add an attachment where the content is contained in a string.
    String content = "This is the content of the 2nd attached file.";
    email.AddStringAttachment("someText.txt",content);

    // Get the email as multi-line base64..
    CkBinData bdMime = new CkBinData();
    email.GetMimeBd(bdMime);

    // Now get it as multi-line base64
    CkStringBuilder sbBase64 = new CkStringBuilder();
    bdMime.GetEncodedSb("base64_mime",sbBase64);

    // Send the HTTP POST (i.e. send the email)
    CkHttpResponse resp = new CkHttpResponse();
    success = http.HttpSb("POST","https://graph.microsoft.com/v1.0/me/sendMail",sbBase64,"utf-8","text/plain",resp);
    if (success == false) {
        Log.i(TAG, http.lastErrorText());
        return;
        }

    // The send succeeded if the response status code = 202.
    // In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
    if (resp.get_StatusCode() != 202) {
        CkJsonObject json = new CkJsonObject();
        json.Load(resp.bodyStr());
        json.put_EmitCompact(false);
        Log.i(TAG, json.emit());
        Log.i(TAG, "Failed, response status code = " + String.valueOf(resp.get_StatusCode()));
        }
    else {
        Log.i(TAG, "Outlook Mail Sent.");
        }


  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}