configuring-imports

Configure Celigo imports with adaptorType, field mappings, and operation logic.

3|2|Updated May 20, 2026
One-click install
npx skills add https://github.com/celigo/ai --skill configuring-imports
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-imports
Source: https://github.com/celigo/ai/tree/main/skills/configuring-imports
Command: npx skills add https://github.com/celigo/ai --skill configuring-imports

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you configure Celigo imports so upstream records can be written to the right destination system with correct mapping, operation logic, and optional AI-safe handling.

Core Features & Use Cases

  • Configure import destinations for APIs, databases, ERPs, files, and AI models using the correct adaptorType and adaptor config block.
  • Set up mapping and transformation (Mapper 2.0 by default, Mapper 1.0 for NetSuite/Salesforce) including lookups, hardcoded values, and field resolution.
  • Control CRUD and sync behavior with operation logic (create/update/upsert/delete/attach/detach) and one-to-many fan-out.
  • Add pipeline hooks and response handling using preMap/postMap/postSubmit and planning response mapping for downstream steps.
  • Handle file-based and AI imports including record-to-file generation and AI agent/guardrail invocation.

Example: Configure an import that writes transformed customer records from a flow into a REST API, performs upsert based on an existing ID, and uses postSubmit to log results and pass enriched fields downstream.

Quick Start

Create a new import JSON that sets name, adaptorType, and the appropriate adaptor block (for example http{}, rdbms{}, s3{}, or ai agent config), then add Mapper 2.0 mappings and an operation/upsert strategy that matches your destination behavior.

Frequently Asked Questions about configuring-imports

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure upsert logic for Celigo import field mappings?

To configure upsert logic for Celigo imports, you set the operation strategy to create, update, or upsert based on an existing ID within the import JSON. This ensures upstream records are written to the destination system with correct mapping and sync behavior using Mapper 2.0 or Mapper 1.0.

What are preMap, postMap, and postSubmit pipeline hooks used for in data destinations?

preMap, postMap, and postSubmit pipeline hooks are deterministic stages used to inject custom logic during data destination imports. They allow you to transform records before mapping, modify data after mapping, and execute post-submit tasks like logging results or passing enriched fields downstream.

Can I use Celigo imports to write records to REST APIs and databases?

Yes, Celigo imports support writing records to REST APIs, databases, ERPs, files, and AI models. You must set the correct case-sensitive adaptorType—such as http or rdbms—and configure the appropriate adaptor block to target your specific destination system.

How does one-to-many fan-out work when importing records to a destination?

One-to-many fan-out allows a single upstream record to generate multiple records in the destination system during import. It is controlled by the operation logic and field mappings, enabling complex data distribution alongside standard CRUD operations like create, update, delete, attach, and detach.

Do I need a specific adaptor type for AI agent imports and file generation?

Yes, AI agent imports and file generation require specific adaptor types and configuration blocks within the Celigo import JSON. You must configure the ai agent block or file-based adaptor to handle record-to-file generation and AI agent or guardrail invocation properly.

What is the best way to handle response mapping for downstream steps in an import pipeline?

The best way to handle response mapping is to plan it within the import configuration to pass enriched fields downstream. By utilizing postSubmit pipeline hooks, you can capture destination responses and map them for subsequent steps in the integration flow.