---
updatedAt: 2025-10-02T19:38:43.000Z
agentTools:
  projectIndex: https://docs.quable.com/v5-EN/llms.txt
---

# Scheduled Imports

Import on a regular basis? Set a schedule!

The **Scheduled Imports** page allows you to define and schedule recurring imports. These imports are launched automatically at the frequency you define.  The page includes a brief description of the feature, a link to this documentation page, and a list of existing import schedules, if any.

* If no import schedules have been created yet, a <strong>Schedule Import</strong> button is displayed in both the <strong>Current Scheduled Imports</strong> section and the top right corner of the page.

* If import schedules have already been created, a list is displayed with: the <strong>Name</strong> of the schedule, the import <strong>Profile </strong> used, the <strong><a href="https://en.wikipedia.org/wiki/Cron">Cron Expression</a></strong> for the import, and the <strong>Status</strong> of the import schedule.<br/><br/>The <strong>Schedule Import</strong> button is only displayed in the top right corner of the page.

<Image title="Capture d’écran 2022-12-21 à 17.48.20.png" alt={2880} width={"80%"} src="https://files.readme.io/a73c538-Capture_decran_2022-12-21_a_17.48.20.png" />

At the end of each line of a scheduled import are icons to **Edit** or **Delete** the schedule.

<Image title="editDelete.png" alt={100} width={"auto"} src="https://files.readme.io/1447491-editDelete.png" />

## Creating Schedules

To create a schedule for a recurring import, click the **Schedule Import** button. A form is displayed to define the schedule and its settings.

<Image title="Capture d’écran 2022-12-21 à 17.48.48.png" alt={2862} width={"80%"} src="https://files.readme.io/d4f1d2e-Capture_decran_2022-12-21_a_17.48.48.png" />

The form is divided into four sections: **Schedule Identity**, **Profile**, **Recurrence**, and **File Path**. These are described in detail below.

When you've completed all of the sections, click on the **Create** button to save the schedule.

### Schedule Identity

This section allows you to provide a name and description for the import schedule as well as its status.

<Image title="Capture d’écran 2022-12-21 à 17.49.21.png" alt={2550} width={"80%"} src="https://files.readme.io/6849f06-Capture_decran_2022-12-21_a_17.49.21.png" />

Enter the following information:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Information
      </th>

      <th>
        Description
      </th>

      <th>
        Mandatory
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Name** 
      </td>

      <td>
        The name of the import schedule.
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        **Description** 
      </td>

      <td>
        Enter text to describe the import schedule.
      </td>

      <td>
        No
      </td>
    </tr>

    <tr>
      <td>
        **Active / Inactive** 
      </td>

      <td>
        New schedules are active by default.

        You can click the slide button to set the import schedule to inactive.
      </td>

      <td>
        No
      </td>
    </tr>
  </tbody>
</Table>

### Profile

This is where you can designate the specific import profile to use for the import schedule.

<Image title="Capture d’écran 2022-12-21 à 17.50.17.png" alt={2554} width={"80%"} src="https://files.readme.io/92b4d90-Capture_decran_2022-12-21_a_17.50.17.png" />

You can either:

* select an existing import profile from the dropdown list or

* [create a new import profile](https://docs.quable.com/docs/import-profiles#creating-profiles)  by clicking the **Create Profile** button.

> 🚧 An import profile is mandatory for scheduling imports.

### Recurrence

This section allows you to define the frequency of the import schedule, as well as the time zone to use.

<Image title="Capture d’écran 2022-12-21 à 17.49.21.png" alt={2550} width={"80%"} src="https://files.readme.io/132d73a-Capture_decran_2022-12-21_a_17.49.21.png" />

Enter the following information:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Information
      </th>

      <th>
        Description
      </th>

      <th>
        Mandatory
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Crontab** 
      </td>

      <td>
        Crontabs are recurrence expressions used by most scheduling systems. Also known as cron expressions, they are specifically formatted string of characters to define the individual details of a schedule (e.g., day of the week, time of day, etc.). 

        If you don't already have a cron expression, you can create one by clicking the **Create My Crontab** button. This opens the [FreeFormatter](https://www.freeformatter.com/cron-expression-generator-quartz.html) website where you can follow the instructions to create a cron expression. Once you've created a cron expression, enter it in the *Crontab* entry area.

        * \*Notes\*\*:
          <ul><li>Maximum length: 6 characters</li><li>A validator on the entry area prevents entering expressions with "?". You should consider removing them from the expressions proposed by the Crontab generator. </li></ul>
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        **Time Zone** 
      </td>

      <td>
        The time zone (in *TZ database name* format) for the schedule. Enter at least three characters of the continent/city of the desired time zone. A scrollable list of *TZ database names* is automatically displayed. You can find the full list [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 

        **Examples**

        <ul><li>The TZ database name for Paris, France is: Europe/Paris</li><li>The TZ database name for Austin, Tx is: America/Chicago </li></ul>
      </td>

      <td>
        Yes
      </td>
    </tr>
  </tbody>
</Table>

### File Path

The final section allows you to specify the source (current location) of your import file.

<Image title="Capture d’écran 2022-12-21 à 17.37.47.png" alt={2262} width={"80%"} src="https://files.readme.io/2033def-Capture_decran_2022-12-21_a_17.37.47.png" />

> 🚧 Note
>
> * Scheduled imports can only be performed from remote sources.
> * Import files must have a fixed name (e.g., "my-documents.csv").
> * Import files must be updated between each import. If not updated, the same file will be imported over and over.

Enter the following information:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Information
      </th>

      <th>
        Description
      </th>

      <th>
        Mandatory
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Protocol** 
      </td>

      <td>
        The transfer protocol to use for the  import.

        Possible values:

        <ul><li>http://</li><li>https://</li><li>ftp://</li><li>sftp://</li></ul>

        * \*Note\*\*: Assets can only be from HTTP or HTTPS sources.
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        **File path** 
      </td>

      <td>
        The full directory address of the import file.

        * \*Note\*\*: If the file is missing when the import is performed, an error is declared and no file will be linked to the import's  [activity report](https://docs.quable.com/docs/journal-dactivites).
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        **Source connection identifier** 
      </td>

      <td>
        Credentials for connecting to the source containing the import file.
      </td>

      <td>
        Yes
      </td>
    </tr>

    <tr>
      <td>
        **Password** 
      </td>

      <td>
        Password to connect to the source containing the import file.
      </td>

      <td>
        Yes
      </td>
    </tr>
  </tbody>
</Table>

## Editing Schedules

You can modify an import schedule by selecting one from the **Current Scheduled Imports** list and clicking its **Edit** icon.

<Image title="Capture d’écran 2022-12-21 à 17.52.51.png" alt={2880} width={"80%"} src="https://files.readme.io/ba755c8-Capture_decran_2022-12-21_a_17.52.51.png" />

The **Edit Scheduled Import** page is displayed. It, shows all of the settings for the schedule, as well as for the import profile it uses.

<Image title="Capture d’écran 2022-12-21 à 17.53.51.png" alt={2880} width={"80%"} src="https://files.readme.io/4cef964-Capture_decran_2022-12-21_a_17.53.51.png" />

You can edit all of the import schedule's settings with the exception of the import profile. When you've finished making modifications, click the:

* **Save** button to save your changes,
* **Delete** button to delete the import schedule, or
* **Return** link (at the top of the form) to return to the **Scheduled Imports** page without saving the changes.

## Deleting Schedules

You can delete an import schedule in two places. It can be done from the:

<ul>
<li><strong>Scheduled Imports</strong> page - Click on an import schedule's <strong>Delete</strong> icon.</li>
<li><strong>Edit Scheduled Import</strong> page - Select an import schedule from the <strong>Current Scheduled Imports</strong> list and click on its <strong>Edit</strong> icon.<br/><br/>From the <strong>Edit Scheduled Import</strong> page, click the <strong>Delete</strong> button to delete the import schedule.</li>
</ul>

In both cases, a dialog is displayed to cancel or confirm the deletion.

<Image title="Capture d’écran 2022-12-21 à 16.54.04.png" alt={834} width={"auto"} src="https://files.readme.io/9c05344-Capture_decran_2022-12-21_a_16.54.04.png" />

> ❗️ Attention
>
> This action is irreversible. Once an import schedule has been deleted, it can't be recovered.

## Import Status

You can check the status of a scheduled import and get the file used in two ways:

<ul>
<li>
  <a href="https://docs.quable.com/v5.19-EN/docs/journal-dactivites">activity reports</a> and selecting <em>Import</em> for the <strong>Type</strong>

  <Image title="Capture d'écran 2022-12-21 à 17.55.11.png" alt={2880} width={"80%"} src="https://files.readme.io/53b3b8e-Capture_decran_2022-12-21_a_17.55.11.png" />
</li>
<li>the API using <code>api/processes?type=import</code> (Take a look at this <a href="https://docs.quable.com/reference/import#retrieve-last-import-process-manage-response--download-the-source-file">recipe</a>)</li>
</ul>