Skip to main content

Integration

Manage integrations on the Boltic platform — create, edit, sync, pull, and submit for review.

Create an Integration

boltic integration create

The CLI guides you through an interactive setup:

  1. Integration Details — Name (alphanumeric + underscores), description, AI-generated description.
  2. Visual Assets — Icon (SVG required), brand colors.
  3. Integration Type — Workflow Activity, Workflow Trigger, or both.
  4. Categorization — Integration group (Analytics, CRM, ERP, Marketing, etc.), tags, and metadata.

Generated Project Structure

my-integration/
├── schemas/
│ ├── resources/
│ │ └── resource1.json
│ ├── authentication.json
│ ├── base.json
│ └── webhook.json
├── Authentication.mdx
├── documentation/
│ ├── integration.mdx
│ └── trigger.mdx
└── spec.json

File descriptions:

FileDescription
schemas/authentication.jsonAuthentication configuration and parameters
schemas/base.jsonBase integration configuration and parameters
schemas/webhook.jsonWebhook configuration (for trigger integrations)
schemas/resources/Resource-specific schemas
Authentication.mdxAuthentication documentation (optional, when catalogue is enabled)
documentation/integration.mdxActivity documentation (required when activity_type is present)
documentation/trigger.mdxTrigger documentation (required when trigger type is CloudTrigger)
spec.jsonIntegration specification and metadata

Edit an Integration

boltic integration edit

Opens an interactive prompt to select and edit an existing integration.

Sync Changes

boltic integration sync

Pushes all local changes to Boltic Cloud.

Pull Latest Changes

boltic integration pull

Pulls the latest version of an integration from Boltic Cloud.

Submit for Review

boltic integration submit

Submits the integration for the publishing review process.

Check Status

boltic integration status

Typical Development Workflow

# 1. Create the integration
boltic integration create
cd my-integration

# 2. Edit files locally...

# 3. Sync changes to Boltic Cloud
boltic integration sync

# 4. Iterate — edit, sync, repeat

# 5. Submit for review when ready
boltic integration submit