Launch a Live Event

Create a live streaming event with RTMPS ingest, optional recording, viewer access control, and real-time analytics.

What you are building

A managed live stream with a dedicated ingest endpoint, watch URL, and optional recording. WAYSCloud handles transcoding, delivery, and viewer analytics.

When to use this approach

• Conferences, webinars, or product launches
• Internal company broadcasts
• Live training sessions
• Events requiring viewer authentication or ticketing

What you need

• A WAYSCloud account
• A streaming encoder (OBS Studio, Wirecast, or similar)

---

Step 1 — Create the event

Dashboard

1. Open Services → Communication → Live Events in the dashboard
2. Click Create Event
3. Enter name, schedule, and visibility settings
4. Click Create

API

curl -X POST https://api.wayscloud.services/v1/dashboard/live-events \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Annual Conference 2025",
    "slug": "conference-2025",
    "scheduled_start_at": "2025-12-15T14:00:00",
    "scheduled_end_at": "2025-12-15T18:00:00",
    "timezone": "Europe/Oslo",
    "visibility_mode": "public",
    "record_enabled": true,
    "replay_enabled": true,
    "rehearsal_enabled": true,
    "max_bitrate_kbps": 5000
  }'

Response:

{
  "id": "event-abc123",
  "slug": "conference-2025",
  "status": "draft",
  "ingest_url": "rtmps://ingest.wayscloud.services/live/conference-2025",
  "stream_key": "wayscloud_le_sk_abc123_full_key...",
  "watch_url": "https://watch.wayscloud.services/events/conference-2025",
  "embed_url": "https://embed.wayscloud.services/events/conference-2025"
}

Save the stream_key — it is only shown once.

---

Step 2 — Configure your encoder

Open OBS Studio (or your preferred encoder) and set:

• Server: rtmps://ingest.wayscloud.services/live/conference-2025
• Stream Key: your stream key from Step 1

Recommended encoder settings:

• Resolution: 1920x1080 (or 1280x720 for lower bandwidth)
• Bitrate: 3000–5000 kbps
• Codec: H.264
• Audio: AAC, 128 kbps

Optional: Rehearsal

Test your setup before the live broadcast:

curl -X POST https://api.wayscloud.services/v1/dashboard/live-events/event-abc123/rehearsal/start \
  -H "Authorization: Bearer $JWT_TOKEN"

---

Step 3 — Go live

Start the broadcast:

curl -X POST https://api.wayscloud.services/v1/dashboard/live-events/event-abc123/live/start \
  -H "Authorization: Bearer $JWT_TOKEN"

Monitor stream health in real time:

curl https://api.wayscloud.services/v1/dashboard/live-events/event-abc123/health \
  -H "Authorization: Bearer $JWT_TOKEN"

{
  "stream_status": "connected",
  "bitrate_kbps": 4800,
  "resolution": "1920x1080",
  "concurrent_viewers": 2347,
  "ingest_health": "excellent"
}

Share the watch URL with your audience: https://watch.wayscloud.services/events/conference-2025

---

Step 4 — End and review

Stop the broadcast:

curl -X POST https://api.wayscloud.services/v1/dashboard/live-events/event-abc123/live/stop \
  -H "Authorization: Bearer $JWT_TOKEN"

Review analytics:

curl https://api.wayscloud.services/v1/dashboard/live-events/event-abc123/stats \
  -H "Authorization: Bearer $JWT_TOKEN"

{
  "peak_concurrent_viewers": 4521,
  "total_watch_time_hours": 12345,
  "avg_watch_duration_minutes": 87,
  "recording_available": true
}

If recording was enabled, the replay is automatically available at the watch URL.

Related services

• Live Events — full service documentation
• DNS Management — custom domains for streaming
• Object Storage — store recordings

Related guides

• Authentication — API key setup

API reference

• Live Events API — all streaming endpoints