Sample code for 30+ languages & platforms
Unicode C 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

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpRequestW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    const wchar_t *accountSid;
    HCkStringBuilderW url;
    HCkHttpRequestW req;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    BOOL parsed;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putBasicAuth(http,TRUE);
    //  Load the owning Account SID and an API key from application configuration.
    accountSid = L"YOUR_ACCOUNT_SID";
    CkHttpW_putLogin(http,L"YOUR_API_KEY_SID");
    CkHttpW_putPassword(http,L"YOUR_API_KEY_SECRET");
    url = CkStringBuilderW_Create();
    CkStringBuilderW_Append(url,L"https://api.twilio.com/2010-04-01/Accounts/");
    CkStringBuilderW_Append(url,accountSid);
    CkStringBuilderW_Append(url,L"/Messages.json");

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

    resp = CkHttpResponseW_Create();
    reply = CkJsonObjectW_Create();
    success = CkHttpW_HttpReq(http,CkStringBuilderW_getAsString(url),req,resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(url);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 201)) {
        wprintf(L"HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        if ((parsed == TRUE) && (CkJsonObjectW_HasMember(reply,L"code") == TRUE)) {
            wprintf(L"Twilio error %d: %s\n",CkJsonObjectW_IntOf(reply,L"code"),CkJsonObjectW_stringOf(reply,L"message"));
        }

        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(url);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (parsed != TRUE) {
        wprintf(L"Expected a JSON response.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(url);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(reply,L"sid") != 1) || (CkJsonObjectW_JsonTypeOf(reply,L"status") != 1)) {
        wprintf(L"The create response is missing the message SID or status.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(url);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    wprintf(L"Message SID: %s\n",CkJsonObjectW_stringOf(reply,L"sid"));
    wprintf(L"Initial status: %s\n",CkJsonObjectW_stringOf(reply,L"status"));


    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(url);
    CkHttpRequestW_Dispose(req);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);

    }