flowgate

POST /api/integrations/sync • Master upsert: event + tickets + sales in one call

POST /api/integrations/events • Sync/create event by external_id

POST /api/integrations/sales • Push sales data for an event

POST /api/integrations/tickets • Push ticket data

DELETE /api/integrations/tickets/:code • Cancel a ticket

GET /api/integrations/resolve/:external_id • Lookup event by external ID

All endpoints require Authorization: Bearer fg_xxxxx or admin token.

Revenue KPIs auto-compute on every sync. AI features activate immediately.

FlowGate is an AI-powered Sales Orchestrator designed for event organizers and ticketing professionals. It connects to your existing ticketing platform, syncs your events and sales data automatically, and uses AI to help you sell more tickets, optimize revenue, and make smarter marketing decisions.

FlowGate does not replace your ticketing platform. It sits on top of it and adds an intelligent layer of analytics, automation, and AI-driven recommendations.

Step 1: Go to Integrations tab → select your ticketing platform (e.g. Eventbrite) → paste your platform API key → click "Connect Platform".

Step 2: Your events appear in the dropdown at the top bar. Select an event to load its data.

Step 3: Go to AI Command tab → click IQO → get instant optimization actions.

Step 4: Go to Intents tab → log your marketing channels (e.g. "paid social: 1200 tickets, €36k revenue, €4.5k ad spend").

Step 5: Go to Marketing tab → AI generates platform-specific ad copy and campaign strategy.

Step 6: Use the AI Command bar at the top to create automated rules in plain English.

FlowGate connects to your existing events. No manual event creation needed • everything syncs automatically. There are two methods:

Supported platforms: 25+ platforms including Ticketmaster, Eventbrite, Ticket Tailor, Universe, DICE, See Tickets, Eventim, Billetto, Weezevent, Resident Advisor, Festicket, AXS, SeatGeek, StubHub, Tixr, BookMyShow, ComeTogether, and more • plus any platform via Custom API.

The main overview screen. Once you select an event from the dropdown, the Dashboard shows all key metrics and quick-access actions at a glance:

KPI Cards: Tickets sold, revenue, break-even progress, sell-out probability, risk score, ticket velocity, average ticket price, and days until the event.

Charts: Visual ticket sales and revenue trends over time.

Active Rules: A list of all AI-generated rules currently running for this event, with on/off toggles.

Notifications: Alerts triggered by rules, risk changes, or important milestones.

Recent Rule Actions: A log of the last actions taken by your automated rules.

Connected Platforms: Status of your platform connections with last sync time.

The Event Status bar next to the dropdown shows a live pulse, ticket count, revenue, and days left for the selected event.

The AI Command tab is your main interface for interacting with FlowGate's AI engine. It has three distinct modes, each with its own purpose and action buttons:

The command bar at the top of every page is a universal AI input that works from any tab. Type any command and press Enter or click "Run". AI automatically detects your intent and routes it to the right module:

"Run" button (CTA) — executes whatever you typed. No need to select a mode • AI figures out the right action from your text. This is the fastest way to interact with FlowGate without switching tabs.

The AI Marketing Ad Generator is a complete campaign creation tool powered by Claude AI. It reads your event's real-time sales data (tickets sold, revenue, velocity, risk score, break-even progress, days remaining) and generates ready-to-use advertising content tailored to your event's current performance and urgency level.

What it does: You select a platform and campaign type, and AI produces full ad copy optimized for that channel — including headline, body text, call-to-action button text, audience targeting suggestions, recommended budget, optimal timing, and A/B test variations. The output is ready to paste directly into your ad manager (Facebook Ads Manager, Instagram, Google Ads, or email tool).

What AI delivers per ad: Headline, body copy, CTA button text, audience targeting (demographics, interests, behaviors), budget recommendation (daily/total), optimal run dates, and A/B test variations so you can test what converts best.

Campaign History: Every generated campaign is saved during the session. Scroll down to compare different variations, platforms, and campaign types side by side before deciding which to deploy.

Pro tip: Generate ads for "All Platforms" first to see which channel's copy resonates best, then refine with a custom brief for the strongest channel.

Track where your ticket sales come from. Log marketing channel performance data to see ROI, CPA, and conversion rates per channel. This data also feeds into the AI Marketing Ad Generator and AI Command for smarter recommendations.

KPI Summary: Total tickets, total revenue, total ad spend, blended ROI, and blended CPA across all channels.

Doughnut chart: Ticket distribution per channel — visual breakdown of which channels drive the most volume.

Bar chart: Revenue per channel side by side — quickly spot your highest-revenue sources.

Channel Breakdown: Detailed row for each channel showing tickets, revenue, cost, ROI, and CPA.

Detailed revenue analytics for the selected event. All KPIs compute automatically on every data sync.

KPIs explained:

• Tickets Sold: Total tickets sold vs. expected capacity

• Revenue: Total gross revenue

• Break-Even: Percentage of break-even target reached (if configured)

• Sell-Out Probability: AI-estimated chance of selling all tickets based on velocity trends

• Risk Score (0-100): Overall risk assessment • 0 is low risk (sales on track), 100 is critical

• Velocity: Average tickets sold per day (based on recent trend)

• Average Price: Revenue divided by tickets sold

• Days Left: Calendar days until the event date

Charts: Ticket sales over time and revenue over time • updated on every sync.

Export: Click "Export CSV" to download all revenue data for the selected event.

Recent Actions: Log of rule-triggered actions related to this event.

The Integrations tab has four sections:

1. Platform Connections: Connect to any of 25+ supported ticketing platforms. Select from the dropdown (organized in "Direct Connect" and "Via API/Webhook" groups), paste your API key, click Connect. Auto-pull platforms (Eventbrite, Ticket Tailor) sync every 15 minutes. All others work via webhook/sync API. Manual sync available via the button.

2. FlowGate API Keys: Generate API keys for webhook-based integrations. Give this key + webhook URL to your ticketing platform. Needed for Option B connections and developer access.

3. API Reference: Technical documentation of all Sync API endpoints • for developers building custom integrations.

4. Sync Activity: Log of all recent sync operations • shows what was synced, when, and whether it succeeded.

Access via the profile icon (top-right). Your account page has these sections:

Personal Details: View and edit your name (click the pencil icon). Email, role, and organization are shown but not editable from here.

Plan / Subscription: Shows your current plan, status, renewal/expiry date, and events used. Click "Manage Plan" to go to the Billing tab.

Change Password: Update your password with validation (min 8 chars, 1 letter, 1 number, 1 special character, no spaces).

User Management (Superadmin only): Add new users to your organization, change their roles (Viewer, Manager, Admin), or remove them. Each new user gets a temporary password shown in a toast notification • share it securely. You cannot delete yourself or change your own role from this panel.

Account Actions: Logout or cancel your subscription (if active).

Complete audit trail of all system activity.

Revenue Actions Log: Every action triggered by your revenue rules • what happened, when, which event, and the trigger conditions.

System Audit Log: All administrative actions • logins, API key creation, connection changes, event updates, and more. Each entry shows the action type, user, timestamp, and details.

Manage your subscription and view your current plan details.

Three plans available:

All plans include a free trial. Payments processed securely by Stripe. Cancel anytime from the Billing tab or via Stripe's customer portal.

Break-Even %: How close you are to covering your costs. Set a break-even target when creating or syncing an event. 100% = costs covered.

Sell-Out Probability: Estimated chance of selling all available tickets before the event date. Based on current velocity, days remaining, and tickets left.

Risk Score (0-100): Composite risk indicator. Factors: break-even progress, velocity trend, days remaining, sell-out probability. Below 30 = low risk (green), 30-60 = medium (orange), above 60 = high risk (red).

Velocity: Tickets sold per day, calculated from recent sales patterns. Rising velocity = good momentum. Dropping velocity = may need action.

CPA (Cost Per Acquisition): How much you spend on marketing to acquire one ticket sale. Lower is better. Shown per channel in the Intents tab.

ROI (Return on Investment): Revenue generated vs. marketing cost. Shown as a multiplier (e.g. 8.0x = every €1 spent returned €8 in revenue).

The Rules Engine is an automated system that monitors your event KPIs every 15 minutes and takes action when conditions are met.

How rules work:

1. You create a rule via the AI Orchestrate mode using natural language

2. AI converts your description into structured conditions (e.g. velocity < 20 AND days_to_event < 14)

3. Every 15 minutes, the engine evaluates all active rules against real-time KPIs

4. When conditions match, the rule triggers a notification

5. Each rule has a cooldown period to prevent repeated triggers

Managing rules:

• View all active rules in the Orchestrate panel or on the Dashboard

• Toggle rules on/off without deleting them

• Delete rules you no longer need

• View trigger history in the Audit tab → Revenue Actions Log

Rule modes: Currently rules operate in notify mode • they alert you but don't execute external actions automatically. This ensures you stay in control.

FlowGate runs a background sync cycle every 15 minutes:

1. Pull data from all connected platforms (Option A connections)

2. Update KPIs for every event with new sales data

3. Evaluate rules against updated KPIs

4. Trigger notifications for any rules whose conditions are met

You can also sync manually by clicking the button next to any platform connection. The Sync Activity log in the Integrations tab shows a complete history of all syncs.

All endpoints require authentication: Authorization: Bearer fg_xxxxx (FlowGate API key) or admin token.

POST /api/integrations/sync • Master upsert: event + tickets + sales in one call

POST /api/integrations/events • Sync/create an event by external_id

POST /api/integrations/sales • Push sales data for an event

POST /api/integrations/tickets • Push individual ticket data

DELETE /api/integrations/tickets/:code • Cancel a ticket by code

GET /api/integrations/resolve/:external_id • Lookup event by platform's external ID

Revenue KPIs auto-compute on every sync. AI features activate immediately after the first data sync.

POST /api/integrations/sync
Authorization: Bearer fg_xxxxx
Content-Type: application/json

{
  "event": {
    "external_id": "YOUR-EVENT-ID",
    "name": "Summer Fest 2026",
    "venue": "OAKA Athens",
    "event_date": "2026-07-15",
    "expected_capacity": 10000,
    "break_even_target": 150000
  },
  "sales": {
    "tickets_sold": 3200,
    "revenue_gross": 96000,
    "average_price": 30
  }
}

Set a break-even target: Without it, the break-even KPI and risk score can't calculate properly. Set it when syncing event data or directly in the event settings.

Log all your channels: The more intent data you provide (Intents tab), the better AI can optimize your budget allocation.

Use IQO regularly: Run IQO once a day to get fresh prioritized actions based on the latest sales data.

Create rules early: Set up velocity alerts and risk-based rules as soon as you connect an event. They'll run in the background and notify you before problems escalate.

Check the Audit tab: If you're unsure what happened, the Audit tab has a complete history of all system actions and rule triggers.

Export your data: Use the CSV export in the Dashboard to create external reports or share data with stakeholders.

Can I use FlowGate without a ticketing platform?
Yes • you can push data manually via the Sync API (Option B) or log data through the Intents tab for channel attribution.

How often does data sync?
Every 15 minutes automatically for Direct Platform Connections. You can also sync manually at any time.

Do the AI rules execute actions automatically?
Currently rules are in "notify" mode • they alert you when conditions are met, but don't take external actions. This keeps you in full control.

Can multiple team members use the same account?
Yes • superadmins can add users via My Account → User Management. Each user gets their own login with a role (Viewer, Manager, or Admin). Roles can be changed anytime.

Is my data secure?
Yes. API keys are stored encrypted. All communication is over HTTPS.

What counts as an event?
Each show date counts as one event. For example, if "Chicago the Musical" runs for 20 nights, that's 20 events. A music festival on a single date is 1 event. Your plan limit applies to active (non-completed, non-cancelled) events.

How many events do I get?
Trial: 3 events (14 days, full features). Starter: 15 events. Pro: 60 events. Business: unlimited. Completed or cancelled events don't count towards your limit.

Can I cancel my subscription?
Yes, anytime. Go to Billing tab → Manage Subscription. You'll retain access until the end of your billing period.

What ticketing platforms are supported?
25+ platforms: Ticketmaster, Eventbrite, Ticket Tailor, Universe, DICE, See Tickets, Eventim, Resident Advisor, AXS, SeatGeek, StubHub, ComeTogether, and more. Auto-pull: Eventbrite, Ticket Tailor. All others via API key + webhook. Plus any custom platform via REST API.

Pulse is an AI-powered decision support tool embedded in FlowGate. It helps you make better revenue decisions through a 2-minute structured reflection — designed to prevent panic pricing and emotional discounting.

How it works:

1. Auto-trigger: A banner appears on the Dashboard when risk signals are detected (risk score >60, velocity dropping, break-even below 50%). Click "Start Pulse" on the banner to begin.

2. Manual: Click "Pulse" in the sidebar anytime to open the Pulse panel.

3. Answer 4 quick steps: intensity level, pressure source, core concern, and your next small action.

4. Click "Get Clarity" — AI generates a personalized summary: what's really happening based on your data, what you can control, and a concrete reversible next step.

Goal: Make decisions from clarity, not pressure. When sales are slow and stress is high, Pulse gives you a structured pause before you act — so you don't slash prices or overspend on ads based on emotion.

Dark/Light Mode: Click the moon/sun icon in the top bar to toggle. Your preference is saved automatically.

Language (EN/EL): Click the language button (EN/EL) in the top bar. All UI text switches between English and Greek. Your choice is saved.

FlowGate can be installed as a standalone app on your device • no app store needed.

Desktop (Chrome/Edge): Click the "Install App" button in the sidebar. The browser will prompt you to install.

iOS (Safari): Tap the Share button → "Add to Home Screen".

Android (Chrome): Tap the menu → "Install app" or "Add to Home Screen".

Once installed, FlowGate opens in its own window without browser bars • faster launch, cleaner experience.

In the Dashboard, click "Export CSV" to download all metrics for the selected event. The CSV includes: date, tickets sold, revenue, break-even %, velocity, risk score, sell-out probability, and more. Use it for external reports, stakeholder presentations, or further analysis in Excel/Google Sheets.

FlowGate automatically updates when a new version is deployed. The app detects version changes, clears the old cache, and reloads with the latest code. You don't need to manually refresh • it happens seamlessly. If you ever see stale data, a hard refresh (Ctrl+Shift+R) will force-update.