Configure Schedules | Online Help | Qntrl | Create and Manage Schedules in Qntrl

Configure Schedules

Schedules run a callback (function, standalone card, or circuit) automatically at the times you set, so recurring work happens without manual effort. Use them for automated updates, weekly notifications, monthly reports, and other repeating tasks across your organization.

Business Scenarios

  • Create recurring cards.
  • Send recurring emails automatically.
  • Sync business data and customer contacts.
  • Back up data weekly or monthly.
  • Generate hourly, daily, or weekly reports.
IdeaTo explore more business scenarios, see Schedules use cases.

Create a Schedule   

Set up a schedule that runs a callback at a frequency you define.

Before you start:
  • You have Automation permissions in the organization.
  • You have created the callback you want to run: a function, a standalone card, or a circuit. For more information, see Functions, Standalone cards, and Circuits.
To create a New schedule:
  1. Log in to Qntrl.
  2. In the left pane, click the Settings ⚙️ icon.
  3. Under Automation, select Schedules.
  4. Click New Schedule.
  5. Configure new schedule details:
    1. Name: Enter a name for the schedule.
    2. Frequency: Select one of: Hourly, Daily, Weekly, Monthly, Yearly, or Custom. Configure the fields for the frequency you selected. For more information, see Frequency settings.
    3. Start Date and Time: Select the date and time when the schedule starts running.
    4. Expiry: Select one option:
      1. Set execution limit: Enter the number of runs after which the schedule expires.
      2. Set expiry date: Select the date after which the schedule expires. Set the expiry date after the start date. If the expiry date is earlier than the start date, the schedule is marked complete and never runs.
      3. Never: Schedule runs with no end.
    5. Callback Type: Select one option:
      1. Standalone Card: Click Add, and in the pop-up, create a configuration or select an existing one. For more information, see Standalone cards.
      2. Function: Select a function from the dropdown.
      3. Circuit: Select a circuit from the dropdown.
  6. Click Save.
      

The new schedule appears in the Schedules list with its toggle set to on.

Frequency settings 

Each frequency adds its own fields to the new schedule form. Configure them at step 5 of Create a schedule.

Hourly

Execute: Enter the number of hours between each run.

Daily

Exclude Days Off: Check this box to exclude the schedule on non-working days of your organization. You can configure the Days off for your organization under Date and Time Settings of Organization Setup.

Weekly

Execute On: Select the days of the week to run the schedule.

Monthly

Execute On: select Set specific date or Set specific day

  1. Set specific date: Enter a date of the month from 1 to 31.
  2. Set specific day: Select a named day of the month, such as the first Monday.

Yearly

No extra fields. The schedule runs once a year on the date set in Start Date and Time.

Custom

Run the callback on a pattern you define, either at a repeating interval or at exact clock times.
From Custom Schedule Type, select one option:
  • Recurrence: Runs the callback repeatedly at a fixed interval on the days you select. Use it for steady, repeating runs, for example every 30 minutes on weekdays.
  • Time Slot: Runs the callback at exact clock times that you add on the days you select. Use it for runs at specific times, for example 09:00, 13:00, and 17:00.
If you select Recurrence, configure these fields:
  1. Recurring frequency: Enter the interval between runs in HH:MM. Note that the interval must be between 00:10 (10 minutes) and 24:00 (24 hours).
  2. Select Days: Select the days of the week to run the schedule.
    1. Use Business Days: Select this checkbox to limit runs to working days.
  3. Time Range: Set the start and end times that bound each day's runs.
    1. Use Business Hours: Select this checkbox to limit runs to working hours.
      
Info

The interval is measured from a base time that depends on whether you set a time range:

  • Without a time range, runs start from the time in Start Date and Time and repeat at the interval you set.

  • With a time range, runs start from the range's start time and repeat at the interval you set, within that range.

If you select Time Slot, configure these fields:
  1. Add Time: Enter a time, then add it to the slot. You can add up to 15 time slots. Keep a gap of at least 10 minutes between slots.
  2. Selected Time Slot: Confirm the time you added appears in this field.
  3. Select Days: Select the days of the week to run the schedule.
    1. Use Business Days: Select this checkbox to limit runs to working days.
      
NotesYou set business days and business hours under Date and Time Settings in Organization Setup.

Pause/ Resume Schedule 

Stop a schedule's runs temporarily, then start them again. Pausing halts the callback but keeps the schedule's configuration.

  1. In the left pane, click the Settings ⚙️ icon
  2. Under Automation, select Schedules.
  3. In the schedule row, toggle the button under the Status column:
    1. Toggle it off to pause the schedule.
    2. Toggle it on to resume the schedule.
      

Delete Schedule

Remove a schedule you no longer need.

Warning

This action cannot be undone. Deleting a schedule stops all future runs of its callback.

  1. In the left pane, click the Settings ⚙️ icon

  2. Under Automation, select Schedules.

  3. Hover over the schedule name, then click the More Actions ⋯ menu.

  4. Select Delete.

  5. In the confirmation pop-up, confirm the deletion.

          

Troubleshooting FAQ 

 1. What is the difference between Recurrence and Time Slot? 

  1. Recurrence runs the callback on a fixed interval across a time range, for example every 30 minutes from 09:00 to 17:00.
  2. Time Slot runs the callback at exact times you choose, for example 09:00, 13:00, and 17:00.

2. What happens if the expiry date is before the start date? 

The schedule is marked complete and does not run. Set the expiry date after the start date.

3. How do I stop a schedule from running on weekends and holidays? 

Select Exclude Days Off for a daily schedule, or select Use Business Days for a custom schedule. Both follow the working days set under Date and Time Settings.

4. Can I manage schedules through the API? 

Yes. You can create schedules and perform other schedule operations through the API. For more information, see Schedules API.