SuperHippo AI Voice Agents icon

SuperHippo AI Voice Agents

Manage leads and calls on the SuperHippo AI Voice Agent

Actions18

Call → Bulk Schedule Calls

AI-generated

Summary

Schedule calls in bulk for multiple leads at specified or randomized times within given windows.

Inputs

  • Lead IDs (required) — Comma-separated lead IDs to schedule calls for, with a maximum of 1000 IDs.
  • Scheduling Options — Optional settings to specify the exact scheduling times: either a fixed Scheduled Time with Timezone or a custom random window defined by start and end hours and a Timezone. Leaving this empty schedules calls at random times within each lead's 9-18 local time window.

Output shape

A single response object indicating the scheduling result for the batch of calls.

The operation supports scheduling up to 1000 calls in one request. Calls are scheduled according to either the provided explicit time or within a random window per lead if no scheduling options are provided. No pagination is involved.

Examples

Example 1: Schedule calls at a fixed time for multiple leads

Set Lead IDs to a comma-separated list, specify Scheduled Time (e.g., '14:30') and Timezone (e.g., 'America/New_York') in Scheduling Options.

Example 2: Schedule calls in a randomized window for multiple leads

Set Lead IDs and leave Scheduling Options empty or define Window Start and End Hours with Timezone to have calls randomly scheduled per lead within that time window.

Links

Discussion