Sending Images via SMS with Filepicker and Twilio


If you are a web developer, you know that handling file uploads is not fun. You are either spending time dealing with files and permissions, or learning how your language handles MIME multipart encoding. Then there is the problem of dealing with large file uploads and cross-browser compatibility.

Even when you get the basics figured out, all that you have working is something that allows your users to upload files from their computer. If you want to enable your users to choose photos and files from a service like Facebook, Dropbox, Google Drive or Flickr, well, that’s a whole other story. Integrating these different APIs, normalizing response formats, and maintaining these integrations can be time consuming.

Does this sound familiar? If it does, you will be excited to learn that has made this process a whole lot easier. provides APIs to connect, process, and store any piece of content in your web application. For example if you are building an application that needs to send files or photos to your users via SMS, then you can use with Twilio to make this happen. Let’s explore how to build this.

With, here is the bare minimum HTML that you will need to write to enable someone to send a link to an image via SMS:

As you look over the HTML, pay special attention to the <input name="file" type="filepicker" /> tag and the two <script> tags at the bottom.

When a browser loads this HTML, the Filepicker script will turn any the <input> tag with a type="filepicker" attribute into a special file picking “widget” that opens this dialog when clicked:

After someone has used the dialog to select an image, a URL to that image is inserted into the value of the <input> tag. That URL is what will be submitted as part of the HTTP POST request that will be made when the “Send File” button is clicked.

So far, all that we have is some HTML that will submit a phone number and URL via a POST request. To actually send the message we will need a little bit of server side logic to take the URL and send the SMS to the phone number. For this, we will be using Python with the Flask web development framework. Here is a simple Flask application that will do just that:

If you want to run the code above, here is what you’ll need to do:

  1. Save the Python code in a file named “”.
  2. Create a directory named “templates” in the same directory as the “” file.
  3. Save the HTML in a file named “simple.html” in the “templates” directory.
  4. Run “pip install Flask
  5. Run “pip install twilio
  6. Run “python
  7. Open http://localhost:5000/ in your web browser of choice.

At this point, we have a very basic looking application. It works, but doesn’t look great. Let’s fix that by adding some design from Twitter Bootstrap and a little bit of error handling.

For the design, Twitter Bootstrap comes with CSS for a very nice looking “Horizontal form“. It looks nice, but requires a pretty substantial change to our HTML. For this we will start by modifying the Bootstrap “starter template“, remove the “navbar” and then enter the following HTML into the <body> tag:

Next, lets add some more HTML to let us know if there was an issue sending the SMS or to show us that the SMS was sent successfully. To only show the messages when appropriate, we will use the conditional blocks from the Jinja2 tempting language that Flask uses. Here is what those look like:

And finally, we will update our backend code to take advantage of those changes. Here are the updates that we will make:

After these changes, we’ve got quite a bit more code, but the page we render looks much nicer:

Here is what the page will look like after picking a file and clicking the “Send File” button. You can see that one of the conditional templates has been activated and is showing us what image we just sent and who we sent the image URL to:

Want to try this code out for yourself? Here are the commands that you’ll need to run:

  1. git checkout
  2. cd filepicker-twilio-example
  3. heroku create
  4. heroku config:add TWILIO_ACCOUNT_SID="{{ your Twilio Account SID }}"
  5. heroku config:add TWILIO_AUTH_TOKEN="{{ your Twilio Auth Token }}"
    • Get this information from your Twilio account. If you don’t have one already, sign up for a Twilio account here.
      You will find the values for your “Account SID” and “Auth Token” in your Twilio account here:
      Set “TWILIO_FROM_NUMBER” to any Twilio number you own, you can see a list of what numbers you own here:
  7. heroku config:add FILEPICKER_API_KEY="{{ your filepicker api key}}"
    • This is your Filepicker API key. If you don’t have a Filepicker account yet. If you don’t have one already, sign up for a Filepicker account here.
      You will find your Filepicker API key here:
  8. heroku config
    • Make sure it’s all the settings are correct!
  9. git push heroku master
  10. heroku open

The last command will open your web browser. The browser will load the address where Heroku is hosting the SMS application we have been building. Once you’re looking at the application, here is what you’ll need to do to send yourself a link to an image:

  1. Enter in your cellphone number.
  2. Click the “Pick File” button and upload an image.
  3. Click “Send File” button.

A few seconds after you click the “Send File” button, you will receive an SMS with a URL for the image you just uploaded.

This is a simple demo, but I hope that I’ve given you a taste of the cool things you can do with Filepicker, Twilio, and about 93 lines of code.

What other cool things can you think of that can be built with and Twilio?

  • Song Zheng

    Woah! Sending MMS with, this did not cross my mind at all. Awesome integration, thanks!

    • Simon

      Actually it isn’t MMS, but just a sms with a link :/