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: Eventbrite, TicketTailor, Skiddle, DICE, Universe, Ticketmaster, or any custom platform with an API.

The main overview screen. Once you select an event from the dropdown, the Dashboard shows:

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.

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.

AI Quick Actions: Shortcut buttons to run IQO, Marketing, Intents analysis, or AI analysis with one click.

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 has three modes:

The command bar at the top of every page is a universal AI input. Type any command and press Enter or click Run. It automatically detects what you want:

Sales analysis: "optimize my sales now", "what's my risk?", "should I run a promo?"

Marketing: "generate Instagram ads for last-chance push", "create Facebook ad for early bird"

Channel data: "Facebook ads: 500 tickets, €15000, €3000 spend" — AI parses and saves the intent data

Rules: "if velocity drops below 20/day, alert and suggest flash sale" — creates an automated rule

Questions: "which channel has the best ROI?" — AI analyzes your intent data

The command bar works from any tab — you don't need to navigate to a specific section first.

AI generates platform-specific advertising content based on your real-time sales data. It knows how many tickets you've sold, the revenue, velocity, risk, and days remaining — and tailors the messaging accordingly.

Platforms: Facebook, Instagram, Google Ads, Email, or all at once.

Campaign types: General, Launch, Early Bird, Last Chance, Flash Sale.

How to use:

1. Select an event from the dropdown

2. Choose a platform and campaign type

3. Optionally add a custom brief (e.g. "focus on VIP packages" or "target 25-34 age group")

4. Click "Generate Ads"

Each generated ad includes: headline, body copy, CTA button text, targeting suggestions, and budget recommendations. Quick preset buttons are available for Early Bird, Last Chance, and Flash Sale campaigns.

Campaign history is kept during the session so you can compare different variations.

Track where your ticket sales come from. Log marketing channel performance data to see ROI, CPA, and conversion rates per channel.

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

Doughnut chart: Ticket distribution per channel.

Bar chart: Revenue per channel side by side.

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

How to log data:

Type in natural language, e.g.:

• "Facebook ads: 500 tickets, €15000 revenue, €2000 ad spend, 12000 clicks"

• "organic: 800 tickets, €24000 revenue, no ad spend"

• "email campaign: 400 tickets, €12000 revenue, €200 cost, 8500 clicks"

AI parses your input and saves it. Quick preset buttons are available for Organic, Paid Social, and Email.

AI Channel Optimization: Click "Analyze Channels" and AI evaluates all your channel data, identifies which channels to scale, which to reduce, and recommends optimal budget allocation.

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 directly to your ticketing platform. Select a platform, paste your API key, click Connect. Your events and sales data sync automatically every 15 minutes. 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.

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 Revenue tab 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 — on the Business plan you get multi-user access with role-based permissions (RBAC).

Is my data secure?
Yes. API keys are stored encrypted. All communication is over HTTPS. Platform API keys are used only for read-only data pulls and are never shared.

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?
Direct connect (auto-pull): Eventbrite, TicketTailor. Via webhook/API: any platform that can send HTTP requests — Skiddle, DICE, Universe, Ticketmaster, or custom systems.