SendSpark icon

SendSpark

Create dynamic AI-personalized videos with SendSpark
Join our community

Actions6

Overview

The "Add Prospect" operation in the SendSpark node allows users to create a new prospect within a specified SendSpark workspace and associate that prospect with a dynamic video campaign. This is useful for personalizing AI-generated videos targeted at individual prospects by providing their contact details and custom variables. Typical use cases include marketing automation workflows where personalized video outreach is sent to leads or customers, enabling better engagement through tailored content.

For example, a marketer can add a prospect named "John Doe" with his email and job title, link him to a specific dynamic video campaign, and optionally set custom variables and webhook URLs to track video events related to this prospect.

Properties

Name Meaning
Workspace The SendSpark workspace to use. Can be selected from a list of available workspaces or entered manually by ID.
Dynamic Campaign The dynamic video campaign to associate the prospect with. Selectable from a list filtered by the chosen workspace or entered manually by ID.
Contact Name Full name of the prospect (e.g., "John Doe").
Contact Email Email address of the prospect (e.g., "prospect@example.com").
Allow Duplicate Prospects Whether to allow creating a new prospect even if one with the same email already exists (true/false).
Deduplication Strategy Strategy to handle existing prospects with the same email: "Keep First Valid" or "Keep Last Valid".
Company Name Company name of the prospect (e.g., "Acme Corp").
Job Title Job title of the prospect (e.g., "Marketing Manager").
Background URL URL to use as background for the personalized video (e.g., "https://example.com").
Custom Variables Additional custom key-value pairs for personalization. Multiple variables can be added, each with a name and value.
Webhook URL Optional webhook URL to receive notifications for this specific prospect. Supports templating with parameters like contact email.
Webhook Events List of events to listen for via webhook for this prospect. Options include: Video Generated, Video Viewed, Video Played, Video Watched, Video Liked, CTA Clicked. Defaults to "Video Generated".
Process and Authorize Charge Hidden property confirming understanding of charges for generating dynamic videos (always true).

Output

The node outputs JSON data representing the result of adding the prospect to the SendSpark system. This typically includes details about the created prospect such as IDs, status, and any relevant metadata returned by the SendSpark API.

If the node supports binary data output (not indicated here), it would represent media files or video content generated, but in this case, the output is focused on JSON response data confirming the prospect creation.

Dependencies

  • Requires an API key credential for authenticating with the SendSpark API.
  • Needs network access to https://api-gw.sendspark.com.
  • The user must have appropriate permissions in the SendSpark workspace to add prospects and access dynamic campaigns.
  • The node uses internal helper methods to fetch lists of workspaces and dynamic campaigns for selection inputs.

Troubleshooting

  • Common Issues:

    • Invalid workspace or campaign ID format: Ensure IDs match the required regex pattern (alphanumeric, underscores, hyphens).
    • Missing required fields such as contact name, email, or dynamic campaign.
    • API authentication errors due to invalid or missing API key credentials.
    • Network connectivity issues preventing access to SendSpark API endpoints.
    • Duplicate prospect conflicts if duplicates are not allowed and deduplication strategy is not properly configured.

  • Error Messages:

    • "Unable to load workspaces" or "Unable to load campaigns": Indicates failure fetching selectable options; check API credentials and network.
    • Validation errors on input fields: Correct the input according to the error message (e.g., invalid ID format).
    • API response errors when adding a prospect: Review the error message for details such as permission denied or invalid data.

Links and References

Discussion