Celigo CLI: Creating Your First Integration with the integrator.io Command Line Interface

Learn how to create your first integrator.io integration using the Celigo CLI, configure integration resources, and manage your integration from the command line.

Published August 12, 2026
Updated August 13, 2026

This tutorial builds on the concepts covered in Getting Started with the Celigo CLI. If you haven’t already installed, configured, and authenticated the Celigo CLI, complete that guide before proceeding.

Creating Your First Integration

The Celigo CLI treats integrator.io resources as JSON documents. For resource creation commands, you provide the resource definition through standard input or, where supported, with --file. This tutorial uses an integrations.json file so the definition can be version-controlled alongside the rest of your integration configuration.

Start by creating a directory for the integration:

mkdir first-integration

Then change into the new directory:

cd first-integration

Create an integrations.json file:

nvim integrations.json

For this example, the file contains the integration name and description:

{
  "name": "first-integration",
  "description": "This is my first integration"
}

The name field is required when creating an integration. The CLI passes the JSON document to the integration creation request.

Create the integration by redirecting integrations.json to the CLI:

celigo integrations create < integrations.json

The < operator redirects the contents of integrations.json to the command’s standard input. The CLI reads that JSON as the resource definition for the creation request.

TIP: The create command reads the resource definition from standard input. If no input is provided, the CLI cannot construct the creation request and returns an error: No input received. Pipe JSON via stdin, or pass –file (where supported).

Once the command completes successfully, the integration is created in integrator.io, and the CLI returns the integration ID, timestamps, name, and other resource properties:

~/first-integration ❯ celigo integrations create < integrations.json
_id                        6a7ed955e27c4161182679de
lastModified               2026-08-14T09:01:09.734Z
name                       first-integration
install                    []
_registeredConnectionIds   []
_registeredLookupCacheIds  []
installSteps               []
uninstallSteps             []
changeEditionSteps         []
flowGroupings              []
apiGroupings               []
createdAt                  2026-08-14T09:01:09.734Z

You can verify the new integration from the integrator.io web interface or query it directly from the CLI.

To list the integrations as JSON:

celigo integrations list --format json

Or use the table format for interactive terminal output:

celigo integrations list --format table

This provides the foundation for the next step in the series. In the next post, Creating Your First Connection with the Celigo CLI, we’ll create and configure a connection that can be used by flows within integrator.io.