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