Skip to content
English
  • There are no suggestions because the search field is empty.

Scheduling, running and downloading a data export

How daily and weekly schedules work, what scheduled files contain, and how to run, download and check the history of an export.

How daily and weekly schedules work, what scheduled files contain, and how to run, download and check the history of an export.

This is for System Admins with an export already saved under Settings, Compliance, Data Exports. "Creating a data export and setting up delivery" covers saving one.

Schedules

Scheduled exports are checked once a day, overnight at 2am. An export is due if it has never run, or if at least a day (Daily) or seven days (Weekly) have passed since its last run. A new scheduled export therefore first runs at the next overnight check.

What a scheduled run contains depends on the delivery type:

  • SFTP: a full snapshot of every application, each time.
  • Email: only applications submitted in the last 24 hours (Daily) or 7 days (Weekly), so the attachment stays a manageable size. A short note under the email address box says this. If nothing falls in the period, no email is sent.

Once you choose Daily or Weekly, a tick box appears: Only include new records. With it ticked, each scheduled send includes only records this export has not sent before, and the 24 hour and 7 day limit on email no longer applies. Leave it unticked to resend everything in the period. Records for agency redacted candidates go out as [Redacted] and are not marked as sent, so they are included again after the candidate is revealed. The tick box only affects scheduled runs. Run now and Download now always give the full set.

The time of a scheduled run is recorded when it starts, even if it then fails. A failed scheduled run is not repeated the next day. The export is tried again when its daily or weekly interval has passed. If you cannot wait, fix the problem and use Run now.

Switching an export on

Scheduled runs, Run now and the per candidate email only work on an export that is switched on. Data exports are currently set up by HireRoad support. Contact us to have a new export switched on. Download now works whether or not the export is switched on.

Run now

An SFTP export that is switched on has a play icon (Run now) on its row. Select it and you see Export run started. The file is built and uploaded in the background, and the result shows in Run history and in the last run date on the row. The file name is your export name with the date added, for example Weekly_payroll-2026-09-29.csv. Running it also resets the schedule timer for that export. If the request fails you see Failed to run export.

Download now

The download icon (Download now) builds the full file straight away and saves it to your computer in the export's chosen format. It ignores the schedule and the Only include new records option. You can request up to 10 downloads a minute. If it fails you see Failed to download export. Downloads are not listed in Run history.

Run history

The clock icon (Run history) opens the last 20 scheduled and manual runs for that export, newest first. Each shows the start time and either Delivered or Last run failed with the error text. An export that has not run shows "This export has not run yet."

Errors you are most likely to see are "Host is not allowed", a login failure from the SFTP server, and the email size message described in "Creating a data export and setting up delivery".