The Sendspark connector lets your AI agent act in each user's Sendspark account. Each user connects their own Sendspark API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 20 tools.
- Tools
- 20
- What they doRead · write · destructive
- 10 · 9 · 110 read9 write1 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Sendspark connection
In AgentKit > Connections, create a Sendspark connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'sendspark'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Sendspark:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'sendspark_workspace_id_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "sendspark"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Sendspark:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="sendspark_workspace_id_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Sendspark credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsendspark_campaign_transcript_getGet the transcript of a campaign video as JSON, WebVTT or SubRip.Read-onlyGet Video Transcript
Get the transcript of a campaign video as JSON, WebVTT or SubRip. Reading never starts a transcription and costs nothing. Returns the transcript (JSON segments, or subtitle text for vtt/srt); 404 when it is not ready. Use sendspark_campaign_transcript_status_get first to check it is ready.
Inputs
campaign_idstringrequired- Campaign (video) ID whose transcript you want. Example: 66c3d4e5f60718293a4b5c6d.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
formatstring- Output: json (default), vtt or srt. Example: json.one of
jsonvttsrt
sendspark_campaign_transcript_status_getCheck whether a campaign video has a transcript and whether it is ready.Read-onlyGet Transcript Status
Check whether a campaign video has a transcript and whether it is ready. Safe to poll; it never starts a transcription. Returns the transcript status, or none when the video never had one. Use this before sendspark_campaign_transcript_get.
Inputs
campaign_idstringrequired- Campaign (video) ID. Example: 66c3d4e5f60718293a4b5c6d.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_dynamic_campaign_getGet one dynamic video campaign with its settings, video and prospects summary.Read-onlyGet Dynamic Video Campaign
Get one dynamic video campaign with its settings, video and prospects summary. Returns the campaign's ID, name, status, video, page settings and prospects. Use sendspark_dynamic_campaigns_list to find IDs.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_dynamic_campaigns_listList the dynamic (AI-personalized) video campaigns in a workspace, with search, sorting and paging.Read-onlyList Dynamic Video Campaigns
List the dynamic (AI-personalized) video campaigns in a workspace, with search, sorting and paging. Returns campaigns with ID, name, status, video settings and prospect counts. Use this to find a campaign_id. Use sendspark_dynamic_campaign_get for one campaign.
Inputs
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
limitinteger- Campaigns to return. Example: 20.
offsetinteger- Campaigns to skip for paging. Example: 0.
projection_typestring- How much detail to return. Example: DEFAULT.one of
DEFAULTDETAILEDMINIMAL prospect_onlyboolean- Only campaigns that have prospects. Example: false.
searchstring- Search text on the campaign name. Example: Q4 outreach.
sort_orderstring- Sort direction. Example: desc.one of
ascdesc
sendspark_dynamics_settings_getGet the workspace-wide settings for dynamic video campaigns.Read-onlyGet Dynamic Video Settings
Get the workspace-wide settings for dynamic video campaigns. Returns the dynamic video settings, such as fallback data behaviour. Use sendspark_dynamic_campaign_settings_update to change a campaign's settings.
Inputs
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_prospect_getGet a prospect in a dynamic video campaign by email, including their personalized video status and links.Read-onlyGet Prospect
Get a prospect in a dynamic video campaign by email, including their personalized video status and links. Returns the prospect's fields, video status and share link, plus emailEmbedHTML or fields when requested. Use this after sendspark_prospect_add to get the video link.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
contact_emailstringrequired- Prospect's email address. Example: jane@acme.com.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
includestring- Comma-separated extra fields: emailEmbedHTML, fields. Example: emailEmbedHTML,fields.
sendspark_webhook_getGet one Sendspark webhook.Read-onlyGet Webhook
Get one Sendspark webhook. Returns its ID, name, URL, module, events, identifiers and enabled state. Use sendspark_webhooks_list to find IDs.
Inputs
webhook_idstringrequired- Webhook ID from sendspark_webhooks_list. Example: 65b2c3d4e5f60718293a4b5c.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_webhooks_listList the webhooks in a Sendspark workspace.Read-onlyList Webhooks
List the webhooks in a Sendspark workspace. Returns each webhook's ID, name, URL, module, events and enabled state. Use this to find a webhook_id.
Inputs
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_workspace_id_getGet the workspace ID that your Sendspark API key belongs to.Read-onlyGet Workspace ID
Get the workspace ID that your Sendspark API key belongs to. Returns the workspace ID. Call this first: every other workspace tool needs workspace_id.
Inputs
This tool takes no inputs.
sendspark_workspaces_listList the Sendspark workspaces the API secret's user belongs to.Read-onlyList Workspaces
List the Sendspark workspaces the API secret's user belongs to. Returns each workspace's ID, name and details. Use sendspark_workspace_id_get for the API key's own workspace.
Inputs
dropdown_renderingboolean- Return a compact list suited to a dropdown. Example: true.
sendspark_campaign_videos_generateGenerate the personalized videos for the prospects already saved in a dynamic video campaign.WriteGenerate Campaign Videos
Generate the personalized videos for the prospects already saved in a dynamic video campaign. Returns the generation result. Use this after saving prospects with sendspark_dynamic_campaign_update. Generating videos can use paid credits.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_dynamic_campaign_createCreate a dynamic video campaign.WriteCreate Dynamic Video Campaign
Create a dynamic video campaign. Record or set its base video in the Sendspark app, then add prospects to get one personalized video each. Returns the new campaign with its ID. Then add prospects with sendspark_prospect_add or sendspark_prospects_bulk_add.
Inputs
namestringrequired- Campaign name. Example: Q4 outreach - SaaS founders.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_dynamic_campaign_settings_updateUpdate a dynamic video campaign's settings.WriteUpdate Campaign Settings
Update a dynamic video campaign's settings. Returns the updated settings. Use this to turn fallback data on or off.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
use_fallback_databooleanrequired- Use fallback values when a prospect field is missing. Example: true.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_dynamic_campaign_updateUpdate a dynamic video campaign's video, landing page content or prospect list.WriteUpdate Dynamic Video Campaign
Update a dynamic video campaign's video, landing page content or prospect list. Returns the updated campaign. Use this to change the title, message, buttons or base video URL. Sending prospect_list with process_and_authorize_charge true processes those prospects.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
buttonsarray- Call-to-action buttons on the landing page, each with label, link and optional position. Example: [{"position": 1, "label": "Book a call", "link": "https://cal.com/me"}]
calendarobject- Calendar embed: provider and link. Example: {"provider": "calendly", "link": "https://calendly.com/me/30min"}
callback_idstring- Your own ID echoed back in webhook events for this request. Example: crm-sync-2026-11-16.
fieldsobject- Campaign variable fields. Example: {"customField": "Hiring"}
messagestring- Landing page message. Example: Thought this might help your team.
namestring- Campaign name. Example: Q4 outreach v2.
process_and_authorize_chargeboolean- Set true when sending prospect_list to authorize charges above your plan limit. Example: true.
prospect_depuration_configobject- Duplicate handling: forceCreation (true to create even if the email exists) and payloadDepurationStrategy (keep-first-valid or keep-last-valid). Example: {"forceCreation": false, "payloadDepurationStrategy": "keep-last-valid"}
prospect_listarray- Prospects to save and process. Prospect fields: contactEmail (required, unique per campaign), contactName, company, jobTitle, customField, backgroundUrl (page shown behind the video), and optionally webhookUrl with webhookEvents for this prospect. Example: [{"contactEmail": "jane@acme.com", "contactName": "Jane", "company": "Acme"}]
titlestring- Landing page title. Example: A quick video for you.
video_urlstring- URL of the base video. Example: https://sendspark.com/share/abc123.
sendspark_prospect_addAdd one prospect to a dynamic video campaign and generate their personalized video.WriteAdd Prospect
Add one prospect to a dynamic video campaign and generate their personalized video. Returns the prospect with its status; the video is generated asynchronously. Use sendspark_prospect_get to read the video link later, or a webhook with video_generated_dv. Use sendspark_prospects_bulk_add for many.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
process_and_authorize_chargebooleanrequired- Must be true: confirms you authorize charges for videos generated above your plan limit. Sendspark rejects the request otherwise. Example: true.
prospectobjectrequired- Prospect fields: contactEmail (required, unique per campaign), contactName, company, jobTitle, customField, backgroundUrl (page shown behind the video), and optionally webhookUrl with webhookEvents for this prospect. Example: {"contactEmail": "jane@acme.com", "contactName": "Jane Doe", "company": "Acme", "jobTitle": "VP Sales", "backgroundUrl": "https://acme.com"}
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
callback_idstring- Your own ID echoed back in webhook events for this request. Example: crm-sync-2026-11-16.
fallback_to_email_domain_for_backgroundboolean- Use the email domain's website as the background when backgroundUrl is missing. Example: true.
prospect_depuration_configobject- Duplicate handling: forceCreation (true to create even if the email exists) and payloadDepurationStrategy (keep-first-valid or keep-last-valid). Example: {"forceCreation": false, "payloadDepurationStrategy": "keep-last-valid"}
sendspark_prospect_background_urls_updateSet or clear every prospect's background URL from their email domain, in one campaign.WriteUpdate Prospect Backgrounds
Set or clear every prospect's background URL from their email domain, in one campaign. Returns the update result. Use true to fill backgroundUrl from each email's domain, false to remove those domain-based URLs.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
extract_url_from_emailbooleanrequired- true sets backgroundUrl from the email domain; false removes background URLs that match the email domain. Example: true.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
sendspark_prospects_bulk_addAdd many prospects to a dynamic video campaign and generate a video for each.WriteBulk Add Prospects
Add many prospects to a dynamic video campaign and generate a video for each. Returns the processing result for the list. Rate-limited to 1 request per minute. Use sendspark_prospect_add for one prospect.
Inputs
campaign_idstringrequired- Dynamic video campaign ID. Get it from sendspark_dynamic_campaigns_list or the create response. Example: 64a1b2c3d4e5f60718293a4b.
process_and_authorize_chargebooleanrequired- Must be true: confirms you authorize charges for videos generated above your plan limit. Sendspark rejects the request otherwise. Example: true.
prospect_listarrayrequired- Prospects to add. Prospect fields: contactEmail (required, unique per campaign), contactName, company, jobTitle, customField, backgroundUrl (page shown behind the video), and optionally webhookUrl with webhookEvents for this prospect. Example: [{"contactEmail": "jane@acme.com", "contactName": "Jane"}, {"contactEmail": "li@globex.com", "contactName": "Li"}]
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
callback_idstring- Your own ID echoed back in webhook events for this request. Example: crm-sync-2026-11-16.
prospect_depuration_configobject- Duplicate handling: forceCreation (true to create even if the email exists) and payloadDepurationStrategy (keep-first-valid or keep-last-valid). Example: {"forceCreation": false, "payloadDepurationStrategy": "keep-last-valid"}
sendspark_webhook_createCreate a webhook that POSTs Sendspark video events (views, plays, CTA clicks, dynamic video generated, MP4 ready) to your URL.WriteCreate Webhook
Create a webhook that POSTs Sendspark video events (views, plays, CTA clicks, dynamic video generated, MP4 ready) to your URL. Returns the new webhook with its ID. Use module dynamics for dynamic video campaigns.
Inputs
modulestringrequired- Scope: global (all videos) or dynamics (dynamic video campaigns). Example: dynamics.one of
globaldynamics namestringrequired- Webhook name. Example: Production Webhook.
urlstringrequired- HTTPS URL that receives the event POSTs. Example: https://example.com/webhook.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
descriptionstring- Webhook description. Example: Webhook for production environment.
eventsarray- Events to send. Leave out for all. Values: video_watched, video_played, video_cta_clicked, video_viewed, video_liked, video_request_received, video_generated_dv, video_mp4_ready, video_generated_error. Example: ["video_generated_dv", "video_watched"]
extra_headersarray- Header names to include in deliveries. Example: ["Authorization"]
identifiersarray- Limit the webhook to these campaign or video IDs. Example: ["64a1b2c3d4e5f60718293a4b"]
sendspark_webhook_updateUpdate a Sendspark webhook's name, URL, events or scope, or turn it on or off.WriteUpdate Webhook
Update a Sendspark webhook's name, URL, events or scope, or turn it on or off. Returns the updated webhook. Fields you leave out stay unchanged.
Inputs
webhook_idstringrequired- Webhook ID from sendspark_webhooks_list. Example: 65b2c3d4e5f60718293a4b5c.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
descriptionstring- Webhook description. Example: Webhook for production environment.
enabledboolean- Turn the webhook on or off. Example: false.
eventsarray- Events to send. Leave out for all. Values: video_watched, video_played, video_cta_clicked, video_viewed, video_liked, video_request_received, video_generated_dv, video_mp4_ready, video_generated_error. Example: ["video_generated_dv", "video_watched"]
extra_headersarray- Header names to include in deliveries. Example: ["Authorization"]
identifiersarray- Limit the webhook to these campaign or video IDs. Example: ["64a1b2c3d4e5f60718293a4b"]
modulestring- Scope: global (all videos) or dynamics (dynamic video campaigns). Example: dynamics.one of
globaldynamics namestring- Webhook name. Example: Production Webhook.
urlstring- HTTPS URL that receives the event POSTs. Example: https://example.com/webhook.
sendspark_webhook_deleteDelete a Sendspark webhook.DestructiveDelete Webhook
Delete a Sendspark webhook. Returns the deletion result. Use sendspark_webhook_update with enabled false to pause it instead.
- Idempotent
Inputs
webhook_idstringrequired- Webhook ID from sendspark_webhooks_list. Example: 65b2c3d4e5f60718293a4b5c.
workspace_idstringrequired- Sendspark workspace ID. Get it from sendspark_workspace_id_get (the workspace of your API key) or sendspark_workspaces_list. Example: 63f6a4145a5e755e2e8fe19d.
No tools match.