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

Up to 50 List of E164-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

Response

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

application/json

200A successful response