Nango Function Builder

What it does

The Nango Function Builder allows you to create and modify deployable functions (actions and syncs) within the Nango platform. It provides repeatable patterns and validation steps to streamline function development, improving productivity for your applications. These functions can be triggered by users or scheduled/webhook-driven events.

When to use it

• You need to build a new action in Nango.
• You want to create a sync within Nango to update cached data.
• You're modifying an existing function within the Nango environment.

Key capabilities

• Supports creation of both Actions (one-time, user-triggered) and Syncs (scheduled/webhook-driven).
• Includes a "Sync Strategy Gate" to guide sync implementation decisions related to checkpoints and delete strategies.
• Provides validation steps using nango dryrun commands for testing and deployment.
• Requires adherence to schema and casing rules when creating or updating functions.

Example prompts

• “Create an action in Nango for [Integration ID] that [brief description of action].”
• "Build a sync in Nango for [Integration ID] using a checkpoint strategy based on [changed-records endpoint]."
• "Modify the existing function [function name] within Nango."

Tips & gotchas

• Before building a Sync, carefully review the references/syncs.md documentation and complete the Sync Strategy Gate.
• Ensure you are working in a Zero YAML TypeScript project (no nango.yaml) located at the Nango root directory (.nango/ exists).
• Validation is crucial; if validation fails with nango dryrun, address missing external state or inputs before proceeding.