Set scheduled_at to create an SMS now and release it for delivery at a future time.
Schedule a message
For a new send, scheduled_at accepts an ISO 8601 timestamp or a relative value such as in 5 min:
Relative scheduling is also supported:
Supported relative units include seconds, minutes, hours, and days. The resolved delivery time must be at least 30 seconds in the future.
Reschedule an SMS
Use PATCH /sms/{message_id} while the SMS is still queued and outside the final mutation cutoff. Rescheduling requires an ISO 8601 timestamp; relative values are not accepted.
Cancel a scheduled SMS
Scheduling rules
- Initial schedules must be at least 30 seconds in the future.
- Rescheduling and cancellation are blocked during the final 15 seconds before delivery.
- Only queued messages with a future
scheduled_at value can be changed or canceled.
- Messages that have already begun processing cannot be changed.
- Use a distinct
Idempotency-Key for each distinct scheduling mutation.
The scheduled time controls when Dugble releases the SMS for delivery. Provider and carrier processing can add latency after that point.
