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

Instagram Integration

Instagram is a popular social networking mobile application with over 300 million users actively sharing photos and videos. Instagram's tools and filters allow users to edit their photos to show their personalities. With Filestack, users can easily upload their Insta-pics to your site.

Current Worldwide Users: 300,000,000

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

Users can select files from Instagram that match these broad file type categories: Only image files are selectable

API OAUTH Webhooks

Using the Instagram API

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

Instagram api upload widget

Upload to Instagram

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

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

Download to Instagram

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

Sample Image Conversion Code for Instagram

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 Instagram and use the Javascript API convert method to resize the image to 400w by 400h in pixels.

Sample Conversion Code
filepicker.pick( { services: ['INSTAGRAM'], 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 Instagram OAuth application to Connect to Filestack:

By default, you do not need to configure anything to start uploading files from Instagram, Filestack is ready to go out of the box. When a user logs into their Instagram 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 an Instagram OAuth Application.

Instagram Webhooks for Your Application

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

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

File Upload (symlink):

File Upload (with store):

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