Embedding SDK Overview

The FlowStack Embedding SDK (@flowstack/embed-sdk) lets you embed FlowStack's automation builder directly into your own product, giving your users the ability to create and manage automations without leaving your app.

Use Cases

• SaaS platforms — Let your users create automations that integrate with your product
• White-label solutions — Offer automation as a feature under your own branding
• Internal tools — Embed the builder into internal dashboards
• Marketplace apps — Let users install and configure automation templates

What You Can Embed

Component	Description
Flow Builder	Full visual automation builder (ActivePieces engine)
Workflow Builder	Advanced node-based builder (n8n engine)
Connections Manager	UI for users to connect their apps
Run History	Execution logs and monitoring
Templates Gallery	Browse and install automation templates

How It Works

1. Install the SDK in your frontend application
2. Generate a JWT token on your backend for each user
3. Render the FlowStack component with the token
4. Users interact with FlowStack within your app's UI
5. Events (flow created, run completed, etc.) are sent to your app via callbacks

Architecture

Your Frontend App
  └── @flowstack/embed-sdk
        └── iframe → FlowStack Builder (app.onflowstack.com)
              └── Your backend ← FlowStack API (webhooks, callbacks)

The SDK renders FlowStack in a sandboxed iframe with seamless SSO authentication. Your users never see the FlowStack login page — they're authenticated automatically via the JWT token you provide.

Requirements

• A FlowStack account on the Pro plan or higher
• A frontend application (React, Vue, Angular, or vanilla JS)
• A backend that can generate JWT tokens

Quick Example

import { FlowStackEmbed } from '@flowstack/embed-sdk';

function AutomationBuilder() {
  return (
    <FlowStackEmbed
      token="eyJhbGciOiJIUzI1NiIs..."
      view="builder"
      theme="light"
      onFlowCreated={(flow) => console.log('Flow created:', flow.id)}
      onFlowRun={(run) => console.log('Run completed:', run.status)}
    />
  );
}

See Installation to get started.