Android™ Requires Chilkat v11.0.0+
Android™
SendGrid: Embed an inline image in an HTML email
See more SendGrid Examples
Read inspection.jpg from the working directory and send it with an HTML inspection report. The image travels with the message: its content_id matches the cid: reference in the HTML. Supply plain text first and include useful alt text so the result is understandable even if the mail client hides images.
Use an API key with Mail Send permission and a verified sender identity. Replace the example addresses before sending.
SendGrid documentation: Mail Send attachment fields.
Chilkat Android™ Downloads
// 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);
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
// Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
http.put_AuthToken("SENDGRID_API_KEY");
CkJsonObject message = new CkJsonObject();
// Replace the sender with a verified sender identity and the recipient with your destination.
message.UpdateString("from.email","sender@example.com");
message.UpdateString("personalizations[0].to[0].email","recipient@example.com");
message.UpdateString("subject","Inspection photo");
message.UpdateString("content[0].type","text/plain");
message.UpdateString("content[0].value","The inspection is complete. The photo shows the repaired hinge.");
// SendGrid expects the plain text alternative before HTML.
message.UpdateString("content[1].type","text/html");
message.UpdateString("content[1].value","<p>The inspection is complete. The photo shows the repaired hinge.</p><img src=\"cid:hinge-photo\" alt=\"Repaired hinge\">");
CkBinData fileData = new CkBinData();
boolean loaded = fileData.LoadFile("inspection.jpg");
if (loaded != true) {
Log.i(TAG, "Could not read inspection.jpg. Check the path and file permissions.");
return;
}
if (fileData.get_NumBytes() == 0) {
Log.i(TAG, "inspection.jpg is empty.");
return;
}
// Encode the file bytes once. The content field contains only Base64, without a data URI prefix.
message.UpdateString("attachments[0].content",fileData.getEncoded("base64"));
message.UpdateString("attachments[0].type","image/jpeg");
message.UpdateString("attachments[0].filename","inspection.jpg");
message.UpdateString("attachments[0].disposition","inline");
message.UpdateString("attachments[0].content_id","hinge-photo");
CkHttpResponse response = new CkHttpResponse();
http.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",message,"application/json",response);
// HttpJson also returns false for HTTP errors. A zero status means no HTTP response arrived.
if (response.get_StatusCode() == 0) {
Log.i(TAG, http.lastErrorText());
return;
}
if (response.get_StatusCode() != 202) {
Log.i(TAG, "Mail Send returned HTTP " + String.valueOf(response.get_StatusCode()));
// For validation errors the response body identifies the offending field and explains why.
Log.i(TAG, response.bodyStr());
return;
}
Log.i(TAG, "SendGrid accepted the email for delivery (HTTP 202).");
}
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."
}
}