Overview
The node enables creating dynamic AI-personalized video campaigns using the SendSpark platform. It is designed to automate the generation of customized videos by specifying campaign details and dynamic variables for personalization. This node is beneficial in marketing automation, personalized outreach, and customer engagement scenarios where tailored video content can improve conversion rates and viewer interaction.
For example, a marketer can create a dynamic video campaign that inserts each recipient’s first name and company logo into the video, making the message feel personal and relevant. The node also supports setting up webhooks to receive notifications about video processing and viewer interactions, enabling real-time tracking and follow-up actions.
Properties
| Name | Meaning |
|---|---|
| Workspace | The SendSpark workspace to use. Can be selected from a searchable list or specified by ID. |
| Campaign Name | Name for the new dynamic video campaign template. |
| Video Template ID | Optional ID of the video template to use for the campaign. This can be set later if not provided initially. |
| Description | Description of the dynamic video campaign. |
| Variables | Dynamic variables for personalization. Each variable has: - Name: Variable identifier (e.g., first_name, company) - Type: Text, Image, or Video - Default Value: fallback value if none provided. |
| Webhook URL | Optional URL to receive webhook notifications when video processing is complete. |
| Webhook Events | Events to listen for via webhook. Options include: - Video Generated - Video Viewed - Video Played - Video Watched - Video Liked - CTA Clicked |
Output
The node outputs JSON data representing the created dynamic video campaign. This typically includes identifiers, status, and metadata about the campaign. If a webhook URL is provided, the node can also handle asynchronous event notifications related to video generation and viewer interactions.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the SendSpark API.
- Needs network access to
https://api-gw.sendspark.com. - The node uses internal helper methods to fetch available workspaces and dynamic campaigns for selection inputs.
- Proper configuration of the webhook endpoint is necessary if webhook notifications are used.
Troubleshooting
- Invalid Workspace ID Format: The workspace ID must match the regex pattern
^[a-zA-Z0-9_-]+$. Ensure no invalid characters are included. - Missing Required Fields: The workspace and campaign name are mandatory. Omitting these will cause errors.
- API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Webhook Failures: If webhook events are enabled but the URL is unreachable or misconfigured, notifications will fail. Check webhook URL correctness and server availability.
- Empty Workspace List: If the workspace list cannot be loaded, it may indicate network issues or invalid credentials. The node provides fallback options to enter IDs manually.