# Flatfile Developer Docs ## Docs - [Actions](https://flatfile.com/docs/core-concepts/actions.md): User-triggered operations in Flatfile - [Apps](https://flatfile.com/docs/core-concepts/apps.md): The anatomy of an App - [Blueprints](https://flatfile.com/docs/core-concepts/blueprints.md): Define your data schema to structure exactly how data should look, behave, and connect - [Documents](https://flatfile.com/docs/core-concepts/documents.md): Standalone webpages within Flatfile Spaces for guidance and dynamic content - [Environments](https://flatfile.com/docs/core-concepts/environments.md): Use Environments for testing and authentication - [Fields](https://flatfile.com/docs/core-concepts/fields.md): Blueprint definitions that define the structure and validation rules for your data in Flatfile - [Jobs](https://flatfile.com/docs/core-concepts/jobs.md): Discrete tasks executed asynchronously in response to events - [Events and Listeners](https://flatfile.com/docs/core-concepts/listeners.md): The anatomy of Events and Listeners - core components of the Flatfile Platform - [Overview](https://flatfile.com/docs/core-concepts/overview.md): Understanding Flatfile's building blocks and architecture - [Plugins](https://flatfile.com/docs/core-concepts/plugins.md): Reusable functionality modules that extend Flatfile's capabilities - [Records](https://flatfile.com/docs/core-concepts/records.md): Individual data rows that represent your imported data in Flatfile - [Sheets](https://flatfile.com/docs/core-concepts/sheets.md): Individual data tables within Workbooks that organize and structure imported data - [Spaces](https://flatfile.com/docs/core-concepts/spaces.md): Micro-applications for content and data storage - [Workbooks](https://flatfile.com/docs/core-concepts/workbooks.md): Database-like containers with type-strict Blueprints for data import - [Angular Embedding](https://flatfile.com/docs/embedding/angular.md): Embed Flatfile in Angular applications - [Authentication](https://flatfile.com/docs/embedding/authentication.md): Authentication and credentials for embedded Flatfile - [JavaScript Embedding](https://flatfile.com/docs/embedding/javascript.md): Embed Flatfile using vanilla JavaScript - [Overview](https://flatfile.com/docs/embedding/overview.md): Embed Flatfile data import directly into your application - [React Embedding](https://flatfile.com/docs/embedding/react.md): Embed Flatfile in React applications - [Vue Embedding](https://flatfile.com/docs/embedding/vue.md): Embed Flatfile in Vue.js applications - [Getting Started with AutoBuild](https://flatfile.com/docs/getting-started/quickstart/autobuild.md): Get up and running with Flatfile in minutes using AutoBuild to create a complete data import solution - [Creating Your First Project](https://flatfile.com/docs/getting-started/quickstart/first-project.md): Running through the import flow with your Flatfile App - [Welcome to Flatfile](https://flatfile.com/docs/getting-started/welcome.md) - [Accepting Additional Fields](https://flatfile.com/docs/guides/accepting-additional-fields.md): Create additional fields on the fly - [Advanced Filters](https://flatfile.com/docs/guides/advanced-filters.md): Learn how to use Flatfile's Advanced Filters to efficiently filter and search through your data - [Authentication and Authorization](https://flatfile.com/docs/guides/authentication.md): Complete guide to authenticating with Flatfile using API keys, Personal Access Tokens, and managing roles and permissions - [Setting Up Your First Listener](https://flatfile.com/docs/guides/create-listener.md): Listeners are the core of Flatfile's event-driven architecture. They respond to events throughout the data import lifecycle, from space configuration to data validation and job processing. This guide will help you understand how to create and organize listeners effectively. - [Data Egress](https://flatfile.com/docs/guides/egress.md): Get data out of Flatfile using various transmission methods and file formats - [Multi-Part Jobs](https://flatfile.com/docs/guides/multi-part-jobs.md): Split up Jobs into Parts - [Guides Overview](https://flatfile.com/docs/guides/overview.md): Comprehensive guides to help you master Flatfile's features and capabilities - [Namespaces](https://flatfile.com/docs/guides/scoping-with-namespaces.md): Narrow down the scope of Spaces, Workbooks, and Sheets - [Secrets](https://flatfile.com/docs/guides/share-secrets.md): Securely use credentials in listeners - [Theming](https://flatfile.com/docs/guides/theme-your-space.md): Learn how to customize the look and feel of Flatfile to match your brand - [Internationalization](https://flatfile.com/docs/guides/translating-your-space.md): Translate and customize your Space with text overrides - [Actions](https://flatfile.com/docs/guides/using-actions.md): Trigger custom operations based on user input - [Using Record Hooks](https://flatfile.com/docs/guides/using-record-hooks.md): Process data with Record Hooks - [Metadata](https://flatfile.com/docs/guides/utilizing-metadata.md): Store descriptive information or data that provides additional context - [Autocast Plugin](https://flatfile.com/docs/plugins/autocast.md): Automatically convert data in a Flatfile Sheet to match the data types defined in the corresponding Blueprint - [Automap Plugin](https://flatfile.com/docs/plugins/automap.md): Automatically map columns for headless data import workflows in Flatfile with configurable confidence levels - [Boolean Validator](https://flatfile.com/docs/plugins/boolean.md): Comprehensive boolean validation plugin for Flatfile that handles various representations of boolean values with multi-language support and flexible configuration options. - [Constraints Plugin](https://flatfile.com/docs/plugins/constraints.md): Extend Flatfile validation capabilities with custom validation logic for complex field and sheet-level constraints - [Currency Conversion Plugin](https://flatfile.com/docs/plugins/currency.md): Automatically converts currency values from a source currency to a target currency using Open Exchange Rates API with support for historical exchange rates. - [Date Format Normalizer](https://flatfile.com/docs/plugins/date.md): Automatically parse and standardize date values during data import, converting various date formats into a consistent output format. - [Deduplicate Sheet Records](https://flatfile.com/docs/plugins/dedupe.md): A Flatfile plugin that provides functionality to find and remove duplicate records from a sheet based on specified field values or custom logic. - [Delimited File Zip Exporter](https://flatfile.com/docs/plugins/delimited-zip.md): Export data from all sheets within a Flatfile Workbook into delimited text files and compress them into a single ZIP archive for download. - [Delimiter Extractor Plugin](https://flatfile.com/docs/plugins/delimiter-extractor.md): Parse text files with custom delimiters and automatically extract structured data for import into Flatfile - [Email Validation Plugin](https://flatfile.com/docs/plugins/email.md): Validate email addresses in Flatfile data imports with format checking, required field validation, and disposable domain blocking - [Export Workbook Plugin](https://flatfile.com/docs/plugins/export-workbook.md): A server-side utility for Flatfile that allows users to export data from an entire Flatfile Workbook into a single, downloadable Microsoft Excel (.xlsx) file. - [Foreign Database Extractor for Microsoft SQL Server](https://flatfile.com/docs/plugins/foreign-db-extractor.md): Automatically extract data from Microsoft SQL Server backup files (.bak) into Flatfile Workbooks for easy data review and processing. - [Geocode Address Data](https://flatfile.com/docs/plugins/geocode.md): Automatically enrich location data using the Google Maps Geocoding API to convert addresses into geographic coordinates and vice-versa. - [GPX File Parser and Analyzer](https://flatfile.com/docs/plugins/gpx.md): Automatically processes GPX (GPS Exchange Format) files to extract waypoints, tracks, routes, and calculate geographic statistics like distance and elevation gain. - [GraphQL Schema to Flatfile Blueprint Converter](https://flatfile.com/docs/plugins/graphql-schema.md): Automatically generate Flatfile Space configurations by converting GraphQL schemas into Workbooks and Sheets, streamlining data import setup for GraphQL APIs. - [HTML Table Extractor](https://flatfile.com/docs/plugins/html-table.md): Parse HTML files and extract data from tables within them, converting structured data into Flatfile-compatible format - [Overview](https://flatfile.com/docs/plugins/index.md): Extend your Flatfile data engine with powerful plugins for extraction, transformation, validation, and integration - [ISBN Validator Plugin](https://flatfile.com/docs/plugins/isbn.md): A Flatfile plugin that validates and formats International Standard Book Number (ISBN) data during the import process, supporting both ISBN-10 and ISBN-13 standards with automatic formatting and conversion capabilities. - [Job Handler Plugin](https://flatfile.com/docs/plugins/job-handler.md): A Flatfile plugin that streamlines the handling of asynchronous Jobs by managing their lifecycle, progress reporting, and completion status. - [JSON Extractor](https://flatfile.com/docs/plugins/json-extractor.md): Parse JSON and JSON Lines files uploaded to Flatfile and extract data into Sheets within a Workbook - [JSON Schema Converter](https://flatfile.com/docs/plugins/json-schema.md): Automatically transform JSON Schema into Flatfile Blueprint for streamlined data model setup - [Markdown File Extractor](https://flatfile.com/docs/plugins/markdown.md): Automatically parse Markdown files and extract tables into Flatfile Sheets - [Merge.dev Connection Plugin](https://flatfile.com/docs/plugins/merge-connection.md): Connect Flatfile to the Merge.dev unified API platform to sync data from hundreds of third-party integrations including HRIS, ATS, CRM, and Accounting systems. - [Number Validation Plugin](https://flatfile.com/docs/plugins/number.md): Comprehensive validation for numeric data during the Flatfile import process with support for ranges, formats, and special number types. - [OpenAPI Schema to Flatfile Blueprint Converter](https://flatfile.com/docs/plugins/openapi-schema.md): Automatically converts OpenAPI v3.0.3 schemas into Flatfile Blueprints to streamline Space setup using existing API data structures - [PDF Extractor Plugin](https://flatfile.com/docs/plugins/pdf-extractor.md): Extract tabular data from PDF files and convert them to CSV format using the pdftables.com service - [Phone Number Validation and Formatting Plugin](https://flatfile.com/docs/plugins/phone.md): Validates and formats phone numbers in Flatfile using country-specific validation with libphonenumber-js library - [Pivot Table Exporter](https://flatfile.com/docs/plugins/pivot-table.md): A Flatfile plugin that performs data analysis and summarization by generating pivot tables from workbook data and uploading them as Markdown documents. - [Record Hook Plugin](https://flatfile.com/docs/plugins/record-hook.md): Execute custom logic on individual data records within a Flatfile Sheet with support for validation, transformation, enrichment, and cleaning. - [Rollout: Automatic Workbook Updates](https://flatfile.com/docs/plugins/rollout.md): Automatically apply schema changes to existing, live workbooks when a new version of a Flatfile Agent is deployed - [Sentiment Analysis Plugin](https://flatfile.com/docs/plugins/sentiment.md): Automatically analyze sentiment in text fields and add sentiment scores and categories to your Flatfile records - [Flatfile Space Configuration Plugin](https://flatfile.com/docs/plugins/space-configure.md): Programmatically set up and configure a new Flatfile Space with workbooks, sheets, documents, and metadata from a single configuration object. - [Space Configure from Template](https://flatfile.com/docs/plugins/space-configure-from-template.md): Automatically configure new Flatfile Spaces by cloning an existing Space Template, including workbooks, documents, and settings. - [SQL DDL to Flatfile Blueprint Converter](https://flatfile.com/docs/plugins/sql-ddl-converter.md): Automatically create Flatfile Blueprints from SQL Data Definition Language (DDL) files to streamline database schema imports. - [Stored Constraints Plugin](https://flatfile.com/docs/plugins/stored-constraints.md): Automatically applies server-side validation rules to records during the data import process using reusable JavaScript functions defined at the App level. - [String Validator Plugin](https://flatfile.com/docs/plugins/string.md): A comprehensive plugin for validating and transforming string data during the Flatfile import process with configurable validation rules, pattern matching, and automatic data corrections. - [Text Summarization and Key Phrase Extraction Plugin](https://flatfile.com/docs/plugins/summarize.md): Automatically enriches Flatfile data by performing text summarization and key phrase extraction on specified text fields using natural language processing. - [Field Translation using Google Translate API](https://flatfile.com/docs/plugins/translate.md): Automatically translate text content in specified fields using Google Translate API and create new fields with translated content - [View Mapped Data Plugin](https://flatfile.com/docs/plugins/view-mapped.md): Automatically hides unmapped columns after the mapping stage to provide a cleaner data review experience - [Webhook Egress](https://flatfile.com/docs/plugins/webhook-egress.md): Send workbook data from Flatfile to external webhook endpoints for seamless integration with your systems - [Webhook Event Forwarder](https://flatfile.com/docs/plugins/webhook-event-forwarder.md): Forward all Flatfile events to a webhook URL for language-agnostic integration with external systems - [What3Words Converter Plugin](https://flatfile.com/docs/plugins/what3words.md): Automatically convert What3Words addresses into standard geographic data including country codes, nearest places, and latitude/longitude coordinates using the official What3Words API. - [Excel Extractor](https://flatfile.com/docs/plugins/xlsx-extractor.md): Parse various Excel file formats (.xls, .xlsx, .xlsm, .xlsb, .xltx, .xltm) and extract structured data with support for header detection, merged cells, and hierarchical spreadsheets. - [XML Extractor](https://flatfile.com/docs/plugins/xml-extractor.md): A Flatfile plugin for parsing XML files, flattening nested structures and attributes, and converting them into tabular format for easy import into Flatfile Sheets. - [YAML Schema to Flatfile Blueprint Converter](https://flatfile.com/docs/plugins/yaml-schema.md): Automates the creation of a Flatfile Blueprint (Workbook and Sheets) from one or more YAML schema definitions, streamlining the setup of a Flatfile Space by converting existing data models into a Flatfile-compatible format. - [Zip Extractor](https://flatfile.com/docs/plugins/zip-extractor.md): Automatically decompress .zip files uploaded to a Flatfile Space and extract their contents as individual files - [CLI Reference](https://flatfile.com/docs/reference/cli.md): Command line interface for developing, deploying, and managing Flatfile Agents - [Event Reference](https://flatfile.com/docs/reference/events.md): Complete reference for all Flatfile events, their payloads, and when they are triggered - [Flatfile Query Language](https://flatfile.com/docs/reference/ffql.md): Learn how to filter data in Sheets with FFQL. - [For LLMs](https://flatfile.com/docs/reference/for-llms.md): AI-optimized documentation formats and tools for better LLM integration - [Icon Reference](https://flatfile.com/docs/reference/icons.md): Reference of all available icons ## Optional - [API Reference](https://reference.flatfile.com) - [Platform](https://platform.flatfile.com)