API Reference

Schedule -- Update

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

Updates an existing scheduled message. Supports partial updates.

Only the fields provided in the request will be updated. Fields not provided will retain their existing values. This follows PATCH semantics.

Added on Dec 5, 2025 for API v2.

Rate limit: 1200 per minute.

Path Params
string
required

The schedule's ID (key string).

Body Params
string | null

[single-line only]

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

string | null

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

string | null

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

int64 | null

Unix timestamp for when to send the message.

string | null

The message text content.

string | null

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

to_numbers
array of strings | null

List of phone numbers to schedule to send messages to.

to_numbers
int64 | null

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

Response

Updated 3 months ago

Language
Credentials
Bearer
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 3 months ago