When embedding Flatfile, this plugin should be deployed in a server-side listener. Learn more


Default: "false"

The debug parameter lets you toggle on/off helpful debugging messages for development purposes.

API Calls

  • api.files.download
  • api.files.get
  • api.files.update
  • api.jobs.ack
  • api.jobs.complete
  • api.jobs.create
  • api.jobs.fail
  • api.jobs.update

Imported NPM Packages


Listen for a ZIP file to be uploaded to Flatfile. The file will be downloaded, unzipped, and the contents uploaded back to Flatfile. Once complete, the file will be ready for import in the Files area. This plugin is designed to be used in conjuction with other extractors, such as the Excel Extractor, to extract and process the contents of the files contained in the ZIP file. Files with names beginning with . will be ignored as these are typically system files (i.e. .DS_store).

npm i @flatfile/plugin-zip-extractor
import { ZipExtractor } from "@flatfile/plugin-zip-extractor";

Full Example

In this example, the ZipExtractor is initialized, and then registered as middleware with the Flatfile listener. When a JSON file is uploaded, the plugin will extract the contents of the ZIP file and upload the files to FlatFile.

import { ZipExtractor } from "@flatfile/plugin-zip-extractor";

// Initialize the ZIP extractor
const zipExtractor = ZipExtractor();

// Register the extractor as a middleware for the Flatfile listener

// When a ZIP file is uploaded, the files will be extracted and uploaded.

See the code