MOmosaic
Triggers

Add YouTube channel listeners

Add YouTube channels to monitor for new videos. Creates a trigger if none exist, updates a trigger with matching filter options when possible, or creates a new trigger node when filter options differ. If a channel already exists on another YouTube trigger node for the same agent, it is moved to the selected trigger node. Execution is deduplicated per target Video Input so matching duplicate trigger tiles do not create duplicate runs for the same target input.

post/agent/{agent_id}/triggers/add_youtube_channels

Request

  • Base URL
    https://api.mosaic.so
  • URL
    https://api.mosaic.so/agent/{agent_id}/triggers/add_youtube_channels
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Path parameters

agent_idstring required

The ID of the agent

Request body

youtube_channelsstring[] required

Array of YouTube channel IDs or URLs to monitor. Channels are moved from other YouTube trigger nodes on the same agent to the selected trigger node when necessary.

trigger_callback_urlstring nullable

Optional webhook URL saved on the YouTube trigger and used as callback_url for each triggered run. Provide null to clear an existing callback URL; omit the field to keep it unchanged.

Response

Listeners added successfully

messagestring
channel_idsstring[]

Canonical YouTube channel IDs derived from the provided inputs (e.g. URLs/handles).

Changes

No recorded changes to this operation across all 1 revision of this API.