Schedule -- Create

post

https://dialpad.com/api/v2/message/schedule

Creates a new scheduled message that will be sent at the specified time.

Messages can be sent to multiple phone numbers OR to a Dialpad channel. Supports both SMS (text only) and MMS (text with media attachments).

Added on Dec 5, 2025 for API v2.

Rate limit: 1200 per minute.

Body Params

channel_hashtag

string | null

[single-line only]

The hashtag of the channel which the message is scheduled for.

from_number

string | null

The personal phone number to use as the sender (must belong to the user).

is_bulk

boolean | null

Defaults to false

Whether this is a bulk message (affects rate limiting and delivery). Maximum of 50 recipients.

media

string | null

Base64-encoded media attachment for MMS (images/videos, max 500 KiB raw file size).

start_date

int64 | null

Unix timestamp for when to send the message (must be 10+ minutes in future).

text

string | null

The message text content.

timezone

string | null

Defaults to US/Pacific

Timezone name (e.g., 'America/Los_Angeles').

to_numbers

array of strings | null

List of up to 50 E.164-formatted phone numbers to send messages to.

to_numbers

user_id

int64 | null

The ID of the user who should be the sender. If not provided, defaults to the authenticated user.

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A successful response