Top Sites>OneSchema | Automate CSV & PDF imports with AI

User-agent: *
Disallow: /lp/

Sitemap: https://www.oneschema.co/sitemap.xml

# OneSchema

> OneSchema is a data-import platform for B2B software teams. It ships (1) an **embeddable Importer** that lets your end users upload, map, and validate CSV/Excel/PDF files inside your app; (2) **Multi FileFeeds**, an AI-powered workflow engine for automating recurring SFTP/S3/webhook file ingestions; and (3) **Templates**, a schema + validation-rule system that both products share. These docs cover setup, SDKs, APIs, customization, security, and operational concepts.

The canonical documentation is hosted at <https://docs.oneschema.co>. Every page is available as Markdown by appending `.md` to the URL (e.g., `https://docs.oneschema.co/docs/getting-started.md`). OpenAPI specs are served at `https://docs.oneschema.co/reference`.

## Core concepts

- [Templates](https://docs.oneschema.co/docs/templates.md): Output schemas defining expected columns, data types, and validation rules.
- [Types of columns](https://docs.oneschema.co/docs/types-of-columns.md): Required, optional, and custom columns.
- [Validations](https://docs.oneschema.co/docs/validations.md): Built-in and custom validation rules applied to template columns.
- [Spreadsheets](https://docs.oneschema.co/docs/spreadsheets.md): How OneSchema parses and normalizes uploaded files.
- [Using Template Data Types](https://docs.oneschema.co/docs/validation-types.md): Built-in types (email, date, enum, regex, etc.).

## Importer (embedded quickstart)

- [Getting Started with Importer](https://docs.oneschema.co/docs/getting-started.md): Overview of the four-pane import flow (Upload → Header → Map → Review).
- [Step 1: Validating with Templates](https://docs.oneschema.co/docs/creating-and-editing-templates.md): Define your target schema.
- [Pane 1: Upload a file](https://docs.oneschema.co/docs/1-upload-a-file.md)
- [Pane 2: Select header row](https://docs.oneschema.co/docs/2-select-header-row.md)
- [Pane 3: Map template columns](https://docs.oneschema.co/docs/3-map-template-columns.md)
- [Pane 4: Review & finalize](https://docs.oneschema.co/docs/4-review-finalize.md)
- [Configuring Import Destinations](https://docs.oneschema.co/docs/importing-validated-data.md): File upload URL, webhook, or direct download.
- [Authenticating User Sessions (JWTs)](https://docs.oneschema.co/docs/generating-jwts.md): How to sign and pass user JWTs.
- [Next Steps](https://docs.oneschema.co/docs/next-steps.md): Advanced Importer workflows common across customers.

## Importer SDKs

- [JavaScript SDK](https://docs.oneschema.co/docs/javascript.md): Vanilla JS — [`@oneschema/importer`](https://www.npmjs.com/package/@oneschema/importer).
- [React SDK](https://docs.oneschema.co/docs/react.md): [`@oneschema/react`](https://www.npmjs.com/package/@oneschema/react).
- [Angular SDK](https://docs.oneschema.co/docs/angular.md): [`@oneschema/angular`](https://www.npmjs.com/package/@oneschema/angular).
- [Vue SDK](https://docs.oneschema.co/docs/vue.md): [`@oneschema/vue`](https://www.npmjs.com/package/@oneschema/vue).
- [Migrate v0.2.x → v0.3.x](https://docs.oneschema.co/docs/migrate-from-v02x-to-v03x.md)
- [Migrate to v0.5.x](https://docs.oneschema.co/docs/migrate-to-v05x.md)
- SDK source: <https://github.com/oneschema/sdk>

## Customization & branding

- [Step 3: Customizing your Importer](https://docs.oneschema.co/docs/customizations.md): Overview of customization surfaces.
- [Using Per-Customer Customization Overrides](https://docs.oneschema.co/docs/configuring-customizations-via-sdk.md): Configure per-customer branding, behavior, and setting overrides via the SDK.
- [Branding Suite (custom colors, fonts, logos)](https://docs.oneschema.co/docs/custom-branding.md)
- [Localization / i18n](https://docs.oneschema.co/docs/translate-importer-into-different-language.md)
- [Inline vs fullscreen iframe](https://docs.oneschema.co/docs/using-fullscreen-mode.md)

## Validation rules & custom logic

- [Using Custom Columns](https://docs.oneschema.co/docs/custom-columns.md): Typed columns without a fixed header key.
- [Using Multi-Mappable Columns](https://docs.oneschema.co/docs/using-multi-mappable-columns.md): One template column matching multiple uploaded columns.
- [Using Per-Customer Template Overrides](https://docs.oneschema.co/docs/per-customer-overrides-v2.md): Runtime add/remove/modify columns per end user.
- [Using Validation Webhooks](https://docs.oneschema.co/docs/validation-webhook.md): Call your API for custom row-level validation.
- [Using Code Hooks](https://docs.oneschema.co/docs/code-hooks.md): Deno/Wasm code executed inside OneSchema for validation & transforms.
- [Updating templates via API](https://docs.oneschema.co/docs/updating-templates-via-api.md)

## Multi FileFeeds (recurring file ingestion)

- [Getting Started with FileFeeds](https://docs.oneschema.co/docs/getting-started-filefeeds.md): Overview of the Multi FileFeeds workflow engine.
- [Step 1: Validating with Templates](https://docs.oneschema.co/docs/step-1-validating-with-templates-copy.md)
- [Step 2: Creating a FileFeed](https://docs.oneschema.co/docs/step-2-creating-a-filefeed.md)
- [Step 3: Using the FileFeed Transform Builder](https://docs.oneschema.co/docs/step-3-using-the-filefeed-transform-builder.md)
- [Uploading large files into Multi FileFeeds](https://docs.oneschema.co/docs/efficient-file-uploads-onto-multi-filefeeds.md): Direct-upload pattern via presigned URLs.

## API reference

- [Importer Embeds API](https://docs.oneschema.co/reference/importer): Launch and manage embedded import sessions.
- [Importer Webhooks](https://docs.oneschema.co/reference/importer-webhooks): Events for the embedded Importer lifecycle.
- [Multi FileFeeds (Workflows) API](https://docs.oneschema.co/reference/workflows): Modern flowgraph-based file ingestion.
- [Templates API](https://docs.oneschema.co/reference/templates): Programmatically manage templates.
- [Validations API](https://docs.oneschema.co/reference/validations): Manage validation rules.
- [Sheets API](https://docs.oneschema.co/reference/sheets): Read/query validated data.
- [SFTP Accounts API](https://docs.oneschema.co/reference/sftp)
- [S3 Accounts API](https://docs.oneschema.co/reference/s3)
- [FileFeeds API (legacy)](https://docs.oneschema.co/reference/filefeeds)
- [Code Hooks API (legacy)](https://docs.oneschema.co/reference/code-hooks)

## Events & integrations

- [Using Event Webhooks](https://docs.oneschema.co/docs/using-events.md): Importer lifecycle events (import started, validated, completed).
- [Configure JWT-based auth for webhooks](https://docs.oneschema.co/docs/configure-jwt-based-authentication-for-webhook.md)
- [MCP Server](https://docs.oneschema.co/docs/mcp-server.md): Expose OneSchema's API & docs to AI coding assistants via the Model Context Protocol.

## Security & compliance

- [SOC 2](https://docs.oneschema.co/docs/soc-2.md)
- [HIPAA](https://docs.oneschema.co/docs/hipaa.md)
- [Data retention policies](https://docs.oneschema.co/docs/data-retention-policies.md)
- [Regional data hosting](https://docs.oneschema.co/docs/regional-data-hosting.md)
- [Enabling SSO for your organization](https://docs.oneschema.co/docs/enabling-sso-for-your-organization.md)

## Usage & billing

- [Tracking file usage](https://docs.oneschema.co/docs/tracking-file-usage.md)
- [Tracking credits](https://docs.oneschema.co/docs/tracking-credits.md)
- [Pricing](https://www.oneschema.co/pricing)

## Optional

- [Using OneSchema AI](https://docs.oneschema.co/docs/ai-bundle.md): AI-assisted column/picklist mapping, natural-language CSV and file transforms, AI-generated validations, and document extraction from PDFs, images, and Excel. All AI features can be disabled instance-wide.
- [Excel → OneSchema conversions](https://docs.oneschema.co/docs/excel-to-oneschema-conversions.md)
- [Accepting JSON files](https://docs.oneschema.co/docs/accepting-json-files.md)
- [Validating relational data](https://docs.oneschema.co/docs/validating-relational-data.md)
- [Using Importer Headless (initialize via API)](https://docs.oneschema.co/docs/initialize-importer-through-api.md)
- [1-Click Mode](https://docs.oneschema.co/docs/1-click-mode.md): Skip panes that have no errors.
- [Environments](https://docs.oneschema.co/docs/environments.md) and [Custom environments](https://docs.oneschema.co/docs/custom-environments.md)
- [Per-customer templates](https://docs.oneschema.co/docs/per-customer-templates.md)
- [Importing warnings (non-blocking)](https://docs.oneschema.co/docs/importing-warnings.md)
- [Importing unmapped columns](https://docs.oneschema.co/docs/unmapped-columns.md): Include uploaded columns that weren't mapped to any template column in the import output.
- [File upload URL destination](https://docs.oneschema.co/docs/file-upload-url.md)
- [Importer webhook destination](https://docs.oneschema.co/docs/importer-webhook.md)
- [Performance benchmarks](https://docs.oneschema.co/docs/oneschema-performance.md)
- [Error message best practices](https://docs.oneschema.co/docs/error-message-best-practices.md)
- [Changelog](https://docs.oneschema.co/changelog)
- [Status page](https://status.oneschema.co)
- [Blog](https://www.oneschema.co/blog)
- [Company & solutions](https://www.oneschema.co)