NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Sendspark connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Sendspark actions, such as "Add Multiple Prospects to Dynamic Campaign", "Add Prospect to Dynamic Video Campaign" and "Create Dynamic Video Campaign V2". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Sendspark, with input parameters and output schema.
SENDSPARK_ADD_MULTIPLE_PROSPECTS_TO_DYNAMIC_CAMPAIGNTool to add multiple prospects to a dynamic campaign in bulk. Use when you need to add many prospects to your dynamic video campaign at once after confirming associated charges.
Input parameters
Dynamic campaign identifier
Workspace identifier
List of prospects to add
Configuration for prospect deduplication
Must be true to confirm usage-based charges
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
SENDSPARK_ADD_PROSPECT_TO_DYNAMIC_VIDEO_CAMPAIGNTool to add a prospect to a dynamic video campaign. Use after confirming workspace and campaign IDs. Example: Add new prospect with name/contact details to dynamic "dyn12345" under a known workspace.
Input parameters
The prospect data to add to the dynamic video campaign.
Identifier of the dynamic video campaign.
Workspace identifier under which the campaign resides.
Optional deduplication settings for prospect creation.
Must be true to acknowledge and authorize any associated charges.
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
SENDSPARK_API_HEALTH_STATUSTool to check the health status of the Sendspark API. Use before making other API calls to ensure the service is up.
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
SENDSPARK_CREATE_DYNAMIC_VIDEO_CAMPAIGN2Tool to create a dynamic video campaign in a workspace. Use when you need to create a container for AI-personalized dynamic videos that can be sent to prospects.
Input parameters
Name of the dynamic campaign. Must be unique within the workspace
The ID of the Sendspark workspace where the campaign will be created
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
SENDSPARK_DELETE_WEBHOOKDelete a webhook by its unique ID. Returns a structured response with status code and message. This action is idempotent: deleting a non-existent webhook (404) with workspaceId provided returns success. Invalid webhook IDs return 400 with error details. Best practice: Always provide workspaceId to use the reliable workspace-scoped endpoint.
Input parameters
Unique identifier of the webhook to delete.
Workspace unique identifier. Required to use the workspace-scoped endpoint (/v1/workspaces/{workspaceId}/webhooks/{webhook_id}). Strongly recommended: The unscoped endpoint (/api/webhooks/{webhook_id}) may not be available.
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
SENDSPARK_GET_DYNAMIC_CAMPAIGN_BY_IDTool to retrieve details of a specific dynamic video campaign. Use after confirming workspace and campaign IDs.
Input parameters
ID of the dynamic campaign to retrieve
ID of the workspace containing the dynamic campaign
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
SENDSPARK_GET_WORKSPACE_PROSPECT_DATA_BY_EMAILTool to retrieve prospect data by email in a dynamic campaign. Use after adding a prospect to a campaign to fetch its details.
Input parameters
Prospect email address to retrieve data for
Dynamic campaign identifier
Sendspark workspace identifier
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
SENDSPARK_LIST_DYNAMIC_VIDEO_CAMPAIGNSTool to list all dynamic video campaigns in a workspace. Use when retrieving campaigns with optional pagination, filtering, or search.
Input parameters
Number of campaigns per page (max 20)
Pagination start index (1-based)
Search by campaign name
Filter by creator ID
Workspace identifier where to list dynamic video campaigns
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
SENDSPARK_LIST_WEBHOOKSRetrieves all configured webhooks for a Sendspark workspace. Webhooks are automated notifications sent when specific events occur in dynamic video campaigns (e.g., video created, video played, CTA clicked, video opened). Use this action to audit active webhook configurations, verify webhook URLs, or check which events are being monitored. Returns an empty list if no webhooks are configured.
Input parameters
Unique identifier for the Sendspark workspace. This alphanumeric ID can be obtained from the workspace settings or by listing dynamic video campaigns.
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
Agents can call 9 Sendspark actions on Nagent, including "Add Multiple Prospects to Dynamic Campaign", "Add Prospect to Dynamic Video Campaign" and "Create Dynamic Video Campaign V2". Add Multiple Prospects to Dynamic Campaign: Add multiple prospects to a dynamic campaign in bulk. Each action is listed on this page with its input parameters and its output.
Sendspark connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Multiple Prospects to Dynamic Campaign takes 4 required inputs: dynamicsId, workspaceId, prospectList and processAndAuthorizeCharge. It also takes 1 optional input: prospectDepurationConfig. It returns data, error and successful.