Send animated GIFs in Ruby using the Giphy API and Twilio MMS.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Animated GIFS via MMS

Custom animated GIFs delivered to your phone via the Giphy API and Twilio MMS.

Text a search phrase to (202) 800-1334 to try it out.

This service is built in Ruby on Sinatra. To run this locally, sign up for a Twilio account and purchase an MMS enabled number for $1. On the Giphy API side, you can build an app using the public beta key, but you'll want to get an individual API key from the Giphy team before scaling to production.


  1. Clone this repo.
  2. Run bundle install to install the gems.
  3. From a terminal, set the following environment variables:
export ACCOUNT_SID=yourtwilioaccountsidhere
export AUTH_TOKEN=yourtwilioauthtokenhere
export TWILIO_PHONE_NUMBER=+13128675309
export GIPHY_API_KEY=yourgiphyapikey
  1. Start the sinatra server:
ruby twilio.rb
  1. Open a tunnel to your local machine. If you use ngrok with custom subdomains, use:
./ngrok -subdomain=example 4567
  1. Click on your shiny new phone number in your Twilio dashboard and set the messaging webhook to

And then send a text message to your Twilio number to get your response. Ping me if you have questions at or @greggyb.