Spotlightr is a video hosting and streaming platform that captures leads, updates contacts with engagement data, and provides analytics reporting.
Spotlightr is a video hosting and streaming platform that captures leads, updates contacts with engagement data, and provides analytics reporting. On Nagent, Spotlightr is exposed as a fully-configurable video & audio integration that any agent can call — 12 actions, and API key authentication. No code is required to wire Spotlightr into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Spotlightr to automate the kinds of tasks video & audio teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Spotlightr into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Spotlightr, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SPOTLIGHTR_ADD_DOMAINTool to add a whitelisted domain for embedding Spotlightr videos. Use when you need to whitelist a new domain for video embedding.
Input parameters
Domain to whitelist for embedding videos (e.g., example.com or test-domain-example.com)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_CREATE_GROUPTool to create a new project (group) in Spotlightr. Use when you need to organize videos into a new project or group.
Input parameters
Name of the project/group to create
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_CREATE_VIDEOTool to create a video in Spotlightr by uploading a file or linking from an external source. Use when you need to add a new video from YouTube, Google Drive, Vimeo, or other sources.
Input parameters
File path or URL to the video source (YouTube, Google Drive, Vimeo, etc.)
Media streaming protocol: 0 to leave as unsecured, 1 to encode with HLS
The name of the video
Type of creation: 0 to debug (test without creating), 1 to confirm creation
Custom S3 integration ID. Use '0' for default storage or provide custom integration ID
Video group ID to associate the video with
Player configuration settings object for customizing video player appearance and behavior
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_DELETE_VIDEOTool to delete or remove videos from Spotlightr projects. Use when you need to permanently delete one or more videos by their IDs.
Input parameters
List of video IDs to delete. Must contain at least one video ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_GET_DOMAINSTool to retrieve whitelisted domains for a Spotlightr account. Use when you need to list all domains approved for embedding videos.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_GET_TOP_VIDEOSTool to retrieve the top videos from a Spotlightr account. Use when you need to list the most viewed videos.
Input parameters
Number of days to look back for top videos (default 30)
Number of top videos to return (default 3)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_GET_VIDEO_METRICSTool to retrieve analytics metrics for a specified video. Use when you have a video ID and need its metrics (loads, plays, playRate, completionRate, shares, etc.).
Input parameters
ID of the video to fetch metrics for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_GET_VIDEO_SOURCETool to get or replace the video source for an existing video in Spotlightr. Use when you need to update a video's source URL.
Input parameters
Video ID whose source is to be replaced
New URL for the video source
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_GET_VIDEO_VIEWSTool to retrieve video view data with optional filtering by viewer ID and watch status. Use when you need detailed view records for a specific video.
Input parameters
Video identifier for retrieving view data
Return all views without pagination
Filter to only include views with percentWatched > 1
ID or email of a known viewer to filter views by specific viewer
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_LIST_GROUPSTool to retrieve all projects (groups) in a Spotlightr account. Use when you need to list all available projects or groups.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_LIST_VIDEOSTool to retrieve videos from a Spotlightr account. Use when you need to list all videos or filter by specific video ID or project.
Input parameters
Identifier for a specific video record to retrieve
Identifier for filtering videos by project association
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SPOTLIGHTR_SEARCH_GLOBALTool to perform account-wide search across all videos and content in Spotlightr. Use when you need to find specific videos, projects, or content by name or keyword.
Input parameters
Search query string to search across videos and content. If not provided, returns all content.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 68 agents privately built on Nagent that already use Spotlightr.
Build on Nagent
Connect Spotlightr to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Spotlightr, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Spotlightr is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Spotlightr is connected, you configure its 12 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Spotlightr steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Spotlightr event fires, the agent kicks off automatically.
Every Spotlightr action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Spotlightr ships with 12 pre-built video & audio actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Spotlightr together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Spotlightr-based workflows tailored to your business.