Schedule a call or SMS, or attempt an immediate callback
Authenticate with a deployed API client whose outboundSchedules explicitly contains flowId/nodeId. Uses the existing applied outbound schedule for channel (voice or Twilio SMS), assistant, sender, contact hours and concurrency. Omit scheduledAt to become due at the next eligible workflow check, or provide a future ISO timestamp including timezone within one year. Automatic checks require an enabled schedule and only select queued contacts when the recipient workflow returns an empty recipients list; a dedicated contact-list workflow is recommended. Set runNow=true instead of scheduledAt to attempt this contact immediately without running the recipient workflow, including with a paused timer. Contact hours, capacity, expiry and sender validation still apply. A deferred attempt remains queued and returns deferredReason; retry the same id with runNow, or let an enabled contact-list workflow pick it up. IDs are scoped to client/workspace/environment/flow/node. Retries do not replace the original recipient or variables, reschedule an existing contact, or redial an already submitted contact. Always reuse the identical payload after an uncertain response. Pending contact retention is 30 days after due time; delivery receipts/deduplication last 30 days. Never reuse an old ID for a new intended contact. No transcripts are returned.
Authentication
Token for one deployed API client, configured in Project → Channels.
Query parameters
Request
Initial assistant variables. Must include those required by the opening message; ld_ variables are reserved.
Response
Existing contact; not inserted again. The returned status describes the existing request.
Stored not-before time when the contact is still pending.
Why an immediate attempt could not claim the contact. The contact remains stored. Retry the same id with runNow to attempt it again; a paused schedule does not automatically retry.