VideoSignal Capture Link Actor

Generate secure VideoSignal capture links, send them to users, and receive uploaded media via webhook.

What VideoSignal Does

VideoSignal lets you collect videos or images from end users through a browser capture page, then notifies your backend when uploads are complete.

What This Actor Does

This actor creates a new VideoSignal capture link by calling the VideoSignal API and writes the link details to the Actor dataset.

It does not upload media itself. End users upload media when they open the generated link.

How Video Links Are Generated

1. Actor reads input (apiKey, webhookUrl, optional settings).
2. Actor calls POST /api/v1/capture-links on VideoSignal.
3. VideoSignal returns a capture link object (id, token, url, expiresAt).
4. Actor stores that result in dataset output.
5. You share captureLink.url with your user.
6. After user completes capture, VideoSignal sends media details to your webhook.

Required Input

• apiKey: VideoSignal API key with capture:create scope
• webhookUrl: HTTPS endpoint that receives upload completion events

Optional Input

• webhookSecret: Secret used to sign webhook payloads (recommended)
• expiresInHours: Link validity duration (default: 168)
• linkSettings: Capture constraints (duration, file size, allowed types, etc.)
• metadata: Custom key-value data returned in webhook payloads
• apiBaseUrl: Override API host if needed

Output Example

{
  "success": true,
  "captureLink": {
    "id": "cl_123",
    "token": "tok_abc",
    "url": "https://app.videosignal.io/c/tok_abc",
    "expiresAt": "2026-03-05T12:00:00.000Z"
  },
  "webhookUrl": "https://example.com/webhooks/videosignal",
  "message": "Capture link created successfully. Videos will be delivered via webhook."
}

Webhook Delivery

When capture is completed, VideoSignal sends an event to your webhookUrl with media metadata and download links.

Recommended:

• Verify webhook signatures when webhookSecret is configured.
• Store captureLink.id and your metadata values to map uploads back to users/workflows.