Getting Started

Filestack Architecture

File Upload

File Export (Save To)

Responsive Images

Image Transformations

Document Transformations

Video Transcoding

Audio Transcoding





Filestack Viewer


Supported Cloud Drives

Filestack Recipes

Filestack Integrations

Filestack SDKs

Register for an API key

Gmail Integration

With over 900 million users, Gmail is available in 72 different languages. A 2014 estimate claimed that 60% of mid-sized US based companies were using Gmail and the Google for business platform. Gmail supports a number of security features including 2-step authentication and can even detect when your account has been compromised. Using the google api Filestack allows your users to grab their attachments out of their sent and received emails and upload or download them to other cloud locations. Start connecting to Gmail with Filestack today!

Current Worldwide Users: 900,000,000

Uploads from the Gmail API support the following types of files:

Users can select files from Gmail that match these broad file type categories: All file types are selectable. This includes audio, video, image, text, office, and compressed archive files.

API OAUTH Webhooks

Using the Gmail API

  1. User selects Gmail from services list
  2. user authenticates connection by logging into Gmail account
  3. user is connected and can select files from Gmail in Filestack dialog

Gmail api upload widget

Upload to Gmail

Uploading or "picking" a file from Gmail in the context of Filestack means choosing a file and creating a distributable link to that file where it exists in Gmail. This is the Filestack URL that all "Pick" functions return. If you are using the pickAndStore method, then the file from Gmail is copied to a new storage location.

Sample Upload Code
filepicker.pick( { mimetypes: ['*/*'], services:['GMAIL'], }, function(Blob){ console.log(replaceHtmlChars(JSON.stringify(Blob))); } );

Download to Gmail

Exporting a file to Gmail with Filestack is not currently possible.

Sample Image Conversion Code for Gmail

If you have a Filestack Blob object or Filestack URL, then you can use the Filestack REST or Javascript APIs to convert office documents and image files. In the sample code below we "pick" an image file from Gmail and use the Javascript API convert method to resize the image to 400w by 400h in pixels.

Sample Conversion Code
filepicker.pick( { services: ['GMAIL'], mimetype: 'image/*', }, function(pickedBlob){ console.log("Conversion in progress...") filepicker.convert( pickedBlob, { width: 400, height: 400, }, { location: 'S3' }, function(convertedBlob){ console.log("Converted file url: ", convertedBlob.url); console.log("File is stored under your S3: ", convertedBlob.key); filepicker.remove( pickedBlob, function(){ console.log("Removed"); } ); } ); } );

Create your own Gmail OAuth application to Connect to Filestack:

By default, you do not need to configure anything to start uploading files from Gmail, Filestack is ready to go out of the box. When a user logs into their Gmail account from your site, the Filestack company application will show up. You can configure it so that your application shows up instead in order to make a more seamless experience for your customers. Click here to learn How to create a Gmail OAuth Application.

Gmail Webhooks for Your Application

You can be notified about all file uploads and conversions from all cloud services Filestack connects to. This includes Gmail. Follow this link to find out more about how to use Filestack's Gmail webhooks.

Here are some examples of the webhooks for uploads from Gmail:

File Upload (symlink):

File Upload (with store):

File Export (save to):
  "action": "fp.export",
  "timestamp": 1444257665,
  "id": 142447,
    "source": "",
    "client": "GMAIL",
    "filename": "newFiletest.jpg",
    "created": ""