Apps

Package your automations as distributable apps for your team, customers, or marketplace.

What Are Apps?

An app is a packaged automation that can be:

• Shared with your team
• Distributed to customers
• Published to a marketplace

Apps include:

• One or more automations
• Required connections
• Configuration options
• Documentation
• Branding

Creating an App

Step 1: Start a New App

1. Navigate to Distribute → Integrations
2. Click + New App
3. Enter app details:
   • Name: Your app's name
   • Description: What it does
   • Icon: Upload an icon (optional)

Step 2: Add Automations

Select which automations to include:

1. Click Add Automation
2. Select from your existing automations
3. Repeat for additional automations

Step 3: Define Configuration

Create configuration options that users fill in when installing:

Config Fields:
  - name: slack_channel
    label: "Slack Channel"
    type: text
    description: "Where to send notifications"
    required: true
    
  - name: frequency
    label: "Check Frequency"
    type: select
    options:
      - "Every 5 minutes"
      - "Every hour"
      - "Daily"

Step 4: Publish

1. Click Publish
2. Choose visibility:
   • Private — Only your workspace
   • Team — Shared with your team
   • Public — Anyone can install

App Structure

My App/
├── Automations/
│   ├── Main Workflow
│   └── Error Handler
├── Config/
│   ├── API Key (required)
│   └── Notification Channel
├── Documentation/
│   ├── Setup Guide
│   └── FAQ
└── Metadata/
    ├── Icon
    ├── Description
    └── Version

Installing Apps

From Your Team

1. Go to Distribute → Integrations
2. Browse the Team Apps section
3. Click Install on the app
4. Fill in configuration
5. Click Activate

From Marketplace

1. Go to Distribute → Integrations
2. Click Marketplace
3. Browse or search for apps
4. Click Install
5. Complete configuration

Managing Apps

View Installed Apps

1. Go to Distribute → Integrations
2. Click Installed
3. See all apps in your workspace

Configure an App

1. Open the installed app
2. Click Configure
3. Update settings
4. Click Save

Uninstall an App

1. Open the installed app
2. Click Uninstall
3. Confirm removal

Versioning

Apps support semantic versioning (v1.0.0, v1.1.0, v2.0.0):

Create a New Version

1. Open your app
2. Click Releases tab
3. Click + New Release
4. Select version type
5. Add release notes
6. Click Publish

App Analytics

Track how your app is used:

Best Practices

Related Guides

• Releases → — Version control for apps
• Portal → — Embed apps for end users
• Automations → — Build workflows for your app