Scheduled Messages

Schedule WhatsApp messages (template or freeform) to be sent at a future time. Sendiee handles the queuing and delivery automatically.

How It Works

When you pass a scheduledAt parameter to the send endpoints (/v2.0/whatsapp/send or /v2.0/whatsapp/message), Sendiee creates a MessageSchedule record and queues it for delivery at the specified time.

Timezone Support

Always pass an IANA timezone string with scheduled messages — for example, Asia/Kolkata, America/New_York, or UTC. If omitted, the timezone defaults to UTC.

RegionIANA Timezone
IndiaAsia/Kolkata
US EasternAmerica/New_York
US PacificAmerica/Los_Angeles
UKEurope/London
UAEAsia/Dubai
DefaultUTC

Scheduling Constraints

  • The scheduled time must be in the future. Sendiee validates this and returns INVALID_SCHEDULE_TIME if the time is in the past.
  • Freeform scheduled messages still respect the 24-hour conversation window at the time of delivery, not at the time of scheduling. If the window expires before delivery, the message will fail.

Schedule Status Flow

scheduled→
senton successful delivery
failedif delivery fails
cancelledif cancelled via API