/
Running A Schedule Manually

Running A Schedule Manually

Summary and Key Differences

Rather than waiting for a configured recurrence to elapse, Schedules can also be run in an ad-hoc manner using the Manual Schedule functionality introduced in the 2025_07 release. These ‘Manual’ Schedules are identical to the Recurring ones in most aspects, e.g. the recipients and the content they will receive, but differ in some key ways:

  • They only run once and will not automatically recur

  • They will not Reschedule any Recurring jobs that have been defined: if you ran a Manual Schedule immediately before a Recurring one was due both would be sent

  • There is an API endpoint available (POST /schedules/{id}/send) to create them

Key Details

  • This new option is usable by anyone who currently has the ability to use the Scheduler preview functionality i.e. people with the ‘Edit Schedule’ User level permission

  • It does not immediately send out the Schedule. It creates a Job for that Schedule available for immediate processing with its ‘Scheduled time’ set to the current time

  • Only one Manual Schedule is allowed to be in progress (either ‘Active’ or ‘Waiting’ on the Monitoring screen) for a particular Schedule at a time. Attempts to create a new Manual Schedule Job prior to the previous one completing will result in an error

  • These jobs will occupy one of the configured number of History Records when applicable

  • They cannot be created on Suspended Schedules and any WAITING/ACTIVE jobs will be cancelled is an Active Schedule is suspended

Creating a Manual Schedule Job

Through the UI:

A new icon has been added to the Schedule Editor screen next to the ‘Preview Envelope’. When clicked, a confirmation popup will load and clicking on ‘Create Job’ will create a Manual Schedule Job and close the popup

Screenshot from 2025-07-02 11-59-56.png

Through the API:

Sending a POST request to /schedules/{id}/send will create a Job for that Schedule provided the authenticated user has the proper access and permission to do so. The ability to create a Manual Job through the API opens up various possibilities for when and under what conditions your configured Schedules are sent out.