Skip to main content

Quick Start

Let's get a live classroom running. You'll have an instructor streaming to students in about 5 minutes.

What You'll Need​

  • A Verriflo account (sign up at verriflo.com)
  • Your Organization ID (from the dashboard)
  • A way to make HTTP requests (cURL, Postman, or your backend)

Step 1: Get Your Organization ID​

Log into the Verriflo Dashboard and grab your Organization ID from the settings page. It looks something like org_abc123xyz.

Keep this handy—you'll need it for every API call.

Step 2: Create a Classroom (Instructor Join)​

Make this API call to create a room and get a join link for the instructor:

curl -X POST https://api.verriflo.com/v1/room/my-first-class/join \
  -H "Content-Type: application/json" \
  -H "VF-ORG-ID: YOUR_ORGANIZATION_ID" \
  -d '{
    "participant": {
      "uid": "instructor-123",
      "name": "Test Instructor",
      "role": "TEACHER"
    }
  }'

You'll get back something like:

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUz...",
    "iframeUrl": "https://live.verriflo.com/iframe/live?token=abc123..."
  }
}

Step 3: Open the Classroom​

Copy that iframeUrl and open it in your browser. You should see:

  1. A permission prompt for your camera and microphone
  2. The classroom interface with your video preview
  3. Controls for camera, mic, screen share, and recording

Congrats—you're now live (to an empty room, but still).

Step 4: Join as a Student​

Let's add a student. Make another API call:

curl -X POST https://api.verriflo.com/v1/room/my-first-class/join \
  -H "Content-Type: application/json" \
  -H "VF-ORG-ID: YOUR_ORGANIZATION_ID" \
  -d '{
    "participant": {
      "uid": "student-456",
      "name": "Test Student",
      "role": "STUDENT"
    }
  }'

Open the new iframeUrl in a different browser (or incognito window). You'll see the student view—watching the instructor's stream.

Step 5: Play Around​

Try these while you have both windows open:

  • Instructor: Toggle your mic on/off. The student should see the mic icon change.
  • Instructor: Share your screen. The student should see it appear.
  • Instructor: Start recording. A red indicator should appear.
  • Student: Notice you can see but can't broadcast.

Step 6: End the Class​

In the instructor window, click "End Class". Both the instructor and student will see the session end.

What Just Happened?​

Here's what Verriflo handled for you:

  1. Room creation — The room was created when the teacher joined
  2. WebRTC negotiation — All the ICE candidates, TURN servers, codec selection
  3. Streaming infrastructure — One-to-many video distribution
  4. UI components — Video player, controls, participant management
  5. Recording — If you enabled it, the class was recorded

All from two API calls.

Next Steps​

Now that you've got the basics:

Integrate with Your App​

Learn the API​

Production Checklist​

Before going live with real users:

  • Set up your organization branding (logo, colors)
  • Verify at least one domain
  • Implement proper error handling
  • Test on mobile devices
  • Set up recording download automation

Common First-Timer Issues​

"Organization not found" error

Double-check your VF-ORG-ID header. Copy it directly from the dashboard—it's case-sensitive.

"Insufficient credits" error

New accounts might need credits. Check your balance in the dashboard.

Camera/mic not working

Make sure you granted permissions when the browser asked. You can also check chrome://settings/content/camera (in Chrome) to see if the site is blocked.

Student can't see instructor

Make sure:

  1. You're using the same roomId for both
  2. The instructor joined first with role TEACHER
  3. The instructor's camera and mic are on

Questions? We're at support@verriflo.com.