Skip to main content
A broadcast sends one approved template to many contacts. The assistant does not schedule it until preview_broadcast has returned a recipient count and you have asked to schedule.

Ask this

After you accept the count:

What the assistant calls

1

Draft

create_broadcast takes templateName and language. The template must already be APPROVED. Optional contactPhones is a list of up to 1,000 numbers with country codes. Pass phoneNumberRef when the account has more than one number.
2

Preview

preview_broadcast counts recipients. The assistant shows you that count. schedule_broadcast stays blocked until you accept it.
3

Schedule

schedule_broadcast takes scheduledDateTime. The time is at least 5 minutes from now and within 30 days. The assistant calls this only after you ask.
delete_broadcast can delete a broadcast that is still PENDING or QUEUED. A broadcast that has started, finished, or is inside the last minute before it starts cannot be deleted. Field details are on Broadcasts.