Sample code for 30+ languages & platforms
JavaScript Requires Chilkat v11.0.0+

Send an MMS with Twilio using a media URL

See more Twilio Examples

Send an image and an optional caption from an MMS-capable Twilio number. Supply an MMS-supported destination in E.164 format and replace the example media URL with an HTTPS URL Twilio can fetch. The host must handle HEAD and GET and return the correct Content-Type for the file.

Live send. With live credentials and valid inputs, this request submits a billable message. Save the Message SID to check delivery later. Supported media types and size limits.

Twilio Messages API reference

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
var http = new CkHttp();
http.RequireSslCertVerify = true;
http.BasicAuth = true;
//  Load the owning Account SID and an API key from application configuration.
var accountSid = "YOUR_ACCOUNT_SID";
http.Login = "YOUR_API_KEY_SID";
http.Password = "YOUR_API_KEY_SECRET";
var url = new CkStringBuilder();
url.Append("https://api.twilio.com/2010-04-01/Accounts/");
url.Append(accountSid);
url.Append("/Messages.json");

//  Add raw field values. Chilkat form-encodes them, including the + in a phone number.
var req = new CkHttpRequest();
req.HttpVerb = "POST";
req.ContentType = "application/x-www-form-urlencoded";
req.AddParam("From","YOUR_MMS_ENABLED_NUMBER");
req.AddParam("To","RECIPIENT_E164_NUMBER");
//  Supply a URL for the file itself so Twilio can retrieve the media.
req.AddParam("MediaUrl","https://media.example.com/photo.jpg");
req.AddParam("Body","Photo attached.");

var resp = new CkHttpResponse();
var reply = new CkJsonObject();
success = http.HttpReq(url.GetAsString(),req,resp);
if (resp.StatusCode == 0) {
    console.log(http.LastErrorText);
    return;
}

var parsed = reply.Load(resp.BodyStr);
if ((success !== true) || (resp.StatusCode !== 201)) {
    console.log("HTTP " + resp.StatusCode);
    if ((parsed == true) && (reply.HasMember("code") == true)) {
        console.log("Twilio error " + reply.IntOf("code") + ": " + reply.StringOf("message"));
    }

    return;
}

if (parsed !== true) {
    console.log("Expected a JSON response.");
    return;
}

if ((reply.JsonTypeOf("sid") !== 1) || (reply.JsonTypeOf("status") !== 1)) {
    console.log("The create response is missing the message SID or status.");
    return;
}

console.log("Message SID: " + reply.StringOf("sid"));
console.log("Initial status: " + reply.StringOf("status"));