Key takeaways
Software teams rely on customer data to activate users and deliver value from day one. Ingestro gives you the infrastructure to import that data at scale—quickly and securely. This guide walks through the core steps to get Ingestro Data Import SDK running in your environment, along with best practices from real-world implementations.
The Importer is the entry point. It's where you enter your license key, basic settings, and how users interact with it.
That's it! You've got your importer up and running.
From here, it's all about defining how your data should look and behave.
The TDM defines your output structure—the columns, data types, and validations that ensure you always get clean and consistent data.
label → Friendly name for userskey → The field name your backend expectscolumnType → Data type (string, int, float, category, date, email, etc.)example → A sample value (visually helps the user)description → A short description on what kind of data the column holdsalternativeMatches → Synonyms to make mapping easier (such as alternate names that you expect to receive in the files)validations → Rules like required, regex, or uniqueHere’s an example:
📘 Tip: Use our AI TDM generator to speed up the process of setting it up direcly from a file or prompting it with natural language.
.png)
.png)
Cleaning Functions let you automatically fix or enrich data during the import process.
You can use them to standardize formats, clean data, or block invalid rows before users even hit “Complete import.”
Here’s an example:
You can also use the Step Handler to hook into each step (upload, mapping, review, etc.) and apply logic like:
With ImporterSession, you can preload data and start the importer at a specific step (for example, at the Review Entries step, including preloaded rows).
This option is perfect for custom workflows or when you already have partially processed data.
Ingestro Data Importer SDK can fully match your brand and audience through white-label customization.
Looks native, feels native.
Give your users superpowers. With Prompts, they can transform or clean data more quickly and more efficiently using natural language commands—right inside the importer.
Examples:
identifier and columns in your settings (both are required).| Step | What to Do | Why it Matters |
|---|---|---|
| 1 | Set up Importer Settings | Establishes core configuration and activates your license key. |
| 2 | Define the TDM | Ensures your data is clean, structured, and validated before entering your system. |
| 3 | Add Cleanings & Handlers | Enables custom logic, transformations, and validation rules tailored to your use case. |
| 4 | Use Dynamic Import | Lets you skip ahead or trigger specific steps—ideal for advanced or pre-formatted imports. |
| 5 | Style & Localize | Matches the importer to your brand’s look, feel, and preferred languages. |
| 6 | Enable AI Prompts | Allows users to fix and transform data using natural-language AI instructions. |
See how easily you can turn your customer files into ready-to-use data with Ingestro’s AI agents.