Get Started with Tapo Cameras

Overview

Seam provides a universal API to connect and control many brands of devices. This guide provides a rapid introduction to connecting your Tapo cameras to Seam, retrieving them as devices, and receiving their motion events. Seam reaches Tapo cameras on the local network through a Seam Bridge. To learn more about other device brands supported by Seam, head over to our integration page.

Tapo cameras are in beta. Tapo, camera events, event media, and live video are available in every workspace, including your sandbox workspace.

1 — Install Seam SDK

Seam provides client libraries for many languages, such as JavaScript, Python, Ruby, PHP, and others, as well as a Postman collection and OpenAPI spec.

JavaScript / TypeScript (npm, GitHub)
Python (pip, GitHub)
Ruby Gem (rubygem, GitHub)
PHP (packagist, GitHub)
C# (nuget, GitHub)
Java (Maven, GitHub)

npm i seam

pip install seam
# For some development environments, use pip3 in this command instead of pip.

bundle add seam

composer require seamapi/seam

Install using nuget: https://www.nuget.org/packages/Seam

// Add to your pom.xml or build.gradle — see Maven Central for details.

# cURL is already installed on most systems. No additional installation needed.
# Export your API key as an environment variable:
export SEAM_API_KEY=seam_test2ZTo_0mEYQW2TvNDCxG5Atpj85Ffw

Once installed, sign up for Seam to get your API key, and export it as an environment variable:

export SEAM_API_KEY=seam_test2ZTo_0mEYQW2TvNDCxG5Atpj85Ffw

This guide uses a Sandbox Workspace. Only virtual devices can be connected. If you need to connect a real Tapo camera, use a non-sandbox workspace and API key.

2 — Link a Tapo Camera with Seam

To use a Tapo camera through the Seam API, you must first authorize your Seam workspace to reach the camera. To do so, Seam provides Connect Webviews: pre-built UX flows that walk you through pairing a Seam Bridge and entering the camera’s connection details. Connect Webviews created without accepted_providers or provider_category include Tapo by default. To show only Tapo, include tapo in the accepted_providers list, or set provider_category to cameras to show all camera brands.

Request a Connect Webview

import { Seam } from 'seam'

const seam = new Seam()

const connectWebview = await seam.connectWebviews.create({
  accepted_providers: ['tapo'],
})

console.log(connectWebview.login_successful) // false

// Send the webview URL to your user
console.log(connectWebview.url)

from seam import Seam

seam = Seam()

webview = seam.connect_webviews.create(
    accepted_providers=["tapo"]
)

assert webview.login_successful is False

# Send the webview URL to your user
print(webview.url)

require "seam"

seam = Seam.new()

webview = seam.connect_webviews.create(
  accepted_providers: ["tapo"]
)

puts webview.login_successful # false

# Send the webview URL to your user
puts webview.url

<?php
use Seam\SeamClient;

$seam = new SeamClient("YOUR_API_KEY");

$webview = $seam->connect_webviews->create(
  accepted_providers: ["tapo"]
);

echo $webview->login_successful; // false

// Send the webview URL to your user
echo $webview->url;

using Seam.Client;

var seam = new SeamClient(apiToken: "YOUR_API_KEY");

var webview = seam.ConnectWebviews.Create(
  acceptedProviders: new List<string> { "tapo" }
);

Console.WriteLine(webview.LoginSuccessful); // false

// Send the webview URL to your user
Console.WriteLine(webview.Url);

import co.seam.Seam;
import co.seam.api.types.ConnectWebview;

Seam seam = Seam.builder().apiKey("YOUR_API_KEY").build();

ConnectWebview webview = seam.connectWebviews().create(
  ConnectWebviewsCreateRequest.builder()
    .acceptedProviders(List.of("tapo"))
    .build()
);

System.out.println(webview.getLoginSuccessful()); // false

// Send the webview URL to your user
System.out.println(webview.getUrl());

curl -X 'POST' \
  'https://connect.getseam.com/connect_webviews/create' \
  -H "Authorization: Bearer ${SEAM_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "accepted_providers": ["tapo"]
  }'

Authorize Your Workspace

Navigate to the URL returned by the Webview object. Since you are using a sandbox workspace, you don’t need to install Seam Bridge. Continue past the Seam Bridge instructions, submit the prefilled sandbox pairing token, and then enter the Tapo sandbox camera details below:

Camera address: camera.test
ONVIF port: 2020
Camera Account username: tapo-test-user
Camera Account password: tapo-test-password
Tapo account password (optional): tapo-sandbox-account-password

Confirm the Connect Webview was successful by querying its status:

const updatedWebview = await seam.connectWebviews.get(
  connectWebview.connect_webview_id,
)

console.log(updatedWebview.login_successful) // true

updated_webview = seam.connect_webviews.get(
    connect_webview_id=webview.connect_webview_id
)

assert updated_webview.login_successful  # true

updated_webview = seam.connect_webviews.get(
  connect_webview_id: webview.connect_webview_id
)

puts updated_webview.login_successful # true

<?php
$updated_webview = $seam->connect_webviews->get(
  connect_webview_id: $webview->connect_webview_id
);

echo $updated_webview->login_successful; // true

var updatedWebview = seam.ConnectWebviews.Get(
  connectWebviewId: webview.ConnectWebviewId
);

Console.WriteLine(updatedWebview.LoginSuccessful); // true

ConnectWebview updatedWebview = seam.connectWebviews().get(
  ConnectWebviewsGetRequest.builder()
    .connectWebviewId(webview.getConnectWebviewId())
    .build()
);

System.out.println(updatedWebview.getLoginSuccessful()); // true

curl -X 'POST' \
  'https://connect.getseam.com/connect_webviews/get' \
  -H "Authorization: Bearer ${SEAM_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d "{
    \"connect_webview_id\": \"${CONNECT_WEBVIEW_ID}\"
  }"

3 — Retrieve the Tapo Camera Device

After a Tapo camera is linked with Seam, you can retrieve it as a device. Each Tapo connected account contains exactly one camera, with the tapo_camera device type. The top-level can_stream_live_video capability flag is true when the camera supports live video and is online. The camera and its paired Seam Bridge must both be online. Check the flag again immediately before opening a live view. The sandbox camera reports true, but the sandbox can’t stream video, so use a real camera to try live view.

const cameras = await seam.devices.list({ device_type: 'tapo_camera' })

const camera = cameras[0]

console.log(camera.properties.online) // true
console.log(camera.can_stream_live_video) // true

console.log(camera)
/*
{
  device_id: '...',
  device_type: 'tapo_camera',
  can_stream_live_video: true,
  properties: {
    online: true,
    manufacturer: 'tapo',
    name: 'C200',
    tapo_metadata: {
      model: 'C200',
      firmware_version: 'fake-1.0',
      hardware_version: 'TAPO-C200-HARDWARE-001'
    }
  },
  ...
}
*/

cameras = seam.devices.list(device_type="tapo_camera")

camera = cameras[0]

assert camera.properties["online"] is True
assert camera.can_stream_live_video is True

print(camera)
# Device(
#   device_id='...',
#   device_type='tapo_camera',
#   can_stream_live_video=True,
#   properties={
#     'online': True,
#     'manufacturer': 'tapo',
#     'name': 'C200',
#     'tapo_metadata': {
#       'model': 'C200',
#       'firmware_version': 'fake-1.0',
#       'hardware_version': 'TAPO-C200-HARDWARE-001'
#     }
#   },
#   ...
# )

camera = seam.devices.list(device_type: "tapo_camera").first

puts camera.properties.online # true

puts camera

<?php
$cameras = $seam->devices->list(device_type: "tapo_camera");

$camera = $cameras[0];

echo $camera->properties->online; // true

var cameras = seam.Devices.List(
  deviceType: Seam.Api.Devices.ListRequest.DeviceTypeEnum.TapoCamera
);

var camera = cameras[0];

Console.WriteLine(camera.Properties.Online); // true

var cameras = seam.devices().list(
  DevicesListRequest.builder()
    .deviceType("tapo_camera")
    .build()
);

var camera = cameras.get(0);

System.out.println(camera.getProperties().getOnline()); // true

curl -X 'POST' \
  'https://connect.getseam.com/devices/list' \
  -H "Authorization: Bearer ${SEAM_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "device_type": "tapo_camera"
  }'

4 — Receive Motion Events

When a connected Tapo camera detects motion, Seam creates a camera.activated event with activation_reason set to motion_detected. To receive these events as they happen, set up a webhook. You can also list events for the camera.

The Tapo sandbox camera doesn’t simulate motion, so this step returns no events in a sandbox workspace. Use a real camera in a non-sandbox workspace to see motion events.

const events = await seam.events.list({
  device_id: camera.device_id,
  event_type: 'camera.activated',
  since: '2026-01-01T00:00:00Z',
})

console.log(events)

events = seam.events.list(
    device_id=camera.device_id,
    event_type="camera.activated",
    since="2026-01-01T00:00:00Z"
)

print(events)

events = seam.events.list(
  device_id: camera.device_id,
  event_type: "camera.activated",
  since: "2026-01-01T00:00:00Z"
)

puts events.inspect

<?php
$events = $seam->events->list(
  device_id: $camera->device_id,
  event_type: "camera.activated",
  since: "2026-01-01T00:00:00Z"
);

echo json_encode($events);

var events = seam.Events.List(
  deviceId: camera.DeviceId,
  eventType: Seam.Api.Events.ListRequest.EventTypeEnum.CameraActivated,
  since: "2026-01-01T00:00:00Z"
);

foreach (var cameraEvent in events)
{
  Console.WriteLine(cameraEvent);
}

var events = seam.events().list(
  EventsListRequest.builder()
    .deviceId(camera.getDeviceId())
    .eventType("camera.activated")
    .since("2026-01-01T00:00:00Z")
    .build()
);

System.out.println(events);

curl -X 'POST' \
  'https://connect.getseam.com/events/list' \
  -H "Authorization: Bearer ${SEAM_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d "{
    \"device_id\": \"${DEVICE_ID}\",
    \"event_type\": \"camera.activated\",
    \"since\": \"2026-01-01T00:00:00Z\"
  }"

Example camera.activated event:

{
  "event_id": "0b7f0d6a-5b1e-4d0c-9d5c-2d8f6a3e1c44",
  "event_type": "camera.activated",
  "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
  "device_id": "a83690b2-2b70-409a-9a94-426699b84c97",
  "connected_account_id": "c9d3f2a1-7b4e-4f0a-8e2d-5a6b7c8d9e0f",
  "activation_reason": "motion_detected",
  "media_ids": [
    "01a0d985-621c-7b3e-9f2d-4a5b6c7d8e9f",
    "01a0d985-621c-7c4f-8a3e-5b6c7d8e9f0a"
  ],
  "video_url": "https://connect.getseam.com/media/get?media_id=01a0d985-621c-7b3e-9f2d-4a5b6c7d8e9f&format=redirect",
  "image_url": "https://connect.getseam.com/media/get?media_id=01a0d985-621c-7c4f-8a3e-5b6c7d8e9f0a&format=redirect",
  "occurred_at": "2026-09-25T17:03:12.000Z",
  "created_at": "2026-09-25T17:03:12.412Z"
}

The event includes media_ids when event media is turned on for your workspace. video_url and image_url point to /media/get with format=redirect, and are included for compatibility. Use media_ids in new integrations.

5 — Retrieve Event Recordings

If you enter the Tapo account password when you connect a real camera, Seam retrieves the camera’s microSD recording of each motion event. The event’s media_ids list a video clip and a thumbnail, which you fetch with /media/get. The returned url expires within minutes, and the media’s expires_at is 7 days after Seam stores the clip. The camera needs a microSD card and Third-Party Compatibility turned on in the Tapo app. For the full flow, see Retrieve Event Media and Tapo event recordings. The sandbox camera accepts the sandbox Tapo account password so that you can test the Connect Webview, but it has no microSD recordings, so its media would end in the unavailable status.

6 — Stream Live Video

Before streaming a Tapo camera’s live video to a browser over WebRTC, check that its can_stream_live_video capability flag is true. The flag is false while the camera or its Seam Bridge is offline. Live video is enabled by default during public beta. Live view uses a client session token scoped to the camera, so your users’ browsers never see your API key. For the full flow and session errors to handle, see Stream Live Video.

Next Steps

Now that you’ve completed this guide, you can try to connect a real Tapo camera. To do so, make sure to switch to a non-sandbox workspace and API key, as real devices cannot be connected to sandbox workspaces. See the Tapo Setup Guide for the Seam Bridge and Camera Account steps. In addition, if you’d like to explore other aspects of Seam, here is a list of helpful resources:

If you have any questions or want to report an issue, email us at support@seam.co.

Overview

Smart Locks

Access Control Systems

Intercoms

Thermostats

Noise Sensors

Cameras

Other Devices

Get Started with Tapo Cameras

Overview

1 — Install Seam SDK

2 — Link a Tapo Camera with Seam

Request a Connect Webview

Authorize Your Workspace

3 — Retrieve the Tapo Camera Device

4 — Receive Motion Events

5 — Retrieve Event Recordings

6 — Stream Live Video

Next Steps

​Overview

​1 — Install Seam SDK

​2 — Link a Tapo Camera with Seam

​Request a Connect Webview

​Authorize Your Workspace

​3 — Retrieve the Tapo Camera Device

​4 — Receive Motion Events

​5 — Retrieve Event Recordings

​6 — Stream Live Video

​Next Steps

Overview

1 — Install Seam SDK

2 — Link a Tapo Camera with Seam

Request a Connect Webview

Authorize Your Workspace

3 — Retrieve the Tapo Camera Device

4 — Receive Motion Events

5 — Retrieve Event Recordings

6 — Stream Live Video

Next Steps