calls

Schedule a new call

Queues an outbound call. Creates the record in QUEUED status (or NOT_STARTED if scheduled for a future time). Runs validation: phone format and country checks (rejects VOIP/premium/shared-cost numbers for US/CA), destination-country restriction (your phone numbers must match the destination country), rate limits, balance check against maxDurationMinutes, and a content safety review. If the goal is ambiguous, the response may be NEEDS_CLARIFICATION with a follow-up question instead of a scheduled call — set force: true to skip clarification.

post/calls/schedule

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/calls/schedule
  • Auth: HTTP bearer

Request body

phoneNumberstring required

Phone number to call

goalstring required

Goal of the call

scheduledAtstring

ISO 8601 date-time for scheduling the call

timezonestring

Timezone for scheduling the call (e.g. America/Los_Angeles)

additionalContextstring

Additional context for the call

maxDurationMinutesnumber

Maximum duration of the call in minutes

doWeNeedToRetryboolean

Do we need to retry the call

voicestring

Voice to use for the call

retryAfterMinutesnumber

Number of minutes to wait before retrying if call fails

forceboolean

Force call creation without clarification

askForClarificationboolean

Allow to ask for clarification (if user is online)

includePrivateDataboolean

Include private data in the call prompt

agentIdstring

Agent ID to use for the call

titlestring

Title of the call (for campaign)

firstMessagestring

First message to use for the call (for campaign)

cronSchedulestring

Cron expression for recurring calls (e.g., "0 9 * * MON" for every Monday at 9 AM)

Response

Call scheduled successfully

successboolean required

Success

Changes

No recorded changes to this operation across all 1 revision of this API.