# Automated Import

{% hint style="info" %}
Automated Import feature is available in the Scale plan only! Feel free to [reach out](https://discord.impler.io) in case you want to try it out!
{% endhint %}

### How do I enable the automated import feature?

The process of automatic data import looks the same as manual data import, where the user uploads a file and impler imports the data. To convert any import to automated import we just need to switch its mode from `Manual` to `Automatic`. Once done your import is transformed from `Manual` to `Automatic` Import Mode.

<figure><img src="https://3446432046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdcNtx1PbzBQcufHhuySW%2Fuploads%2F89Sq88UhTo9TwuVV2q9b%2Fimage.png?alt=media&#x26;token=1003d029-29d9-436d-a113-8cc8ee81b132" alt=""><figcaption><p>Automatic Import</p></figcaption></figure>

### How does Automated Import work?

When we switch import mode to Automatic, the Import widget gets transformed and instead of accepting the file from the user, the import widget asks the user for a source from where data will get imported on interval.

At the moment impler accepts `RSS URL` as a source from where data will be fetched at user-specified intervals. The embed process of automatic import is the same as manual import. Here is how automatic import works:

#### Step 1: Configure

The first step is to provide a source from where data will be imported at regular intervals. Here on RSS URL input, the user can provide the RSS URL and Impler will keep importing data from the URL.

<figure><img src="https://3446432046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdcNtx1PbzBQcufHhuySW%2Fuploads%2Fd0BkrImRvwM03lGeNvHp%2Fimage.png?alt=media&#x26;token=f2941157-0ead-4f03-861e-f5244fbc37df" alt=""><figcaption><p>Configure Source of Automatic Import</p></figcaption></figure>

#### Step 2: Map Columns

The second step is to Map appropriate columns from the RSS file. As RSS follows XML structure, Impler parses the RSS file, extracts all paths for possible values in the XML file, and returns headings. Users can pick an appropriate heading for the column.

<figure><img src="https://3446432046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdcNtx1PbzBQcufHhuySW%2Fuploads%2Ft52SlVjHMalUcLdtgXfM%2Fimage.png?alt=media&#x26;token=12260f3b-7f0a-4988-bfc5-821b09d05bf9" alt=""><figcaption><p>User mapping XML fields with columns</p></figcaption></figure>

#### Step 3: Schedule Timing

Impler imports data from specified sources at regular intervals. In the schedule step user defines the Interval. The ability to specify intervals in Minutes, Hours, Days, Months, and Days makes it limitless for a user to provide any timing.

<figure><img src="https://3446432046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdcNtx1PbzBQcufHhuySW%2Fuploads%2FUipJehAGphyf23bQOCaw%2Fimage.png?alt=media&#x26;token=9071dcbd-eb83-48a4-8321-29a0034b00df" alt=""><figcaption><p>Specifying the interval of automated import</p></figcaption></figure>

#### Step 4: Confirm

At the end, impler confirms the automated import configuration. Which shows the source and when it will run.

<figure><img src="https://3446432046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdcNtx1PbzBQcufHhuySW%2Fuploads%2F3WmfylPCvzpELBjbTzdz%2Fimage.png?alt=media&#x26;token=28027857-7907-4ada-ac44-34f1694d1944" alt=""><figcaption><p>Confirming Automated Import</p></figcaption></figure>

#### Automated Imports are associated with users

Automated imports are associated with users. Users referred to here are users of end application who uses Impler. To mention userId we have to provide `externalUserId` extra parameters. As mentioned in [#passing-extra-parameters](https://docs.impler.io/importer/react-embed#passing-extra-parameters "mention") (React) and [#passing-extra-parameters](https://docs.impler.io/importer/html-js-embed#passing-extra-parameters "mention") (HTML & JS).

You can provide anything in `externalUserId`. ID or Email address that uniquely identifies the user is best suitable for value in `externalUserId`.

### Showing Automated Imports in Application

Automated Imports refers to the user. It becomes obvious to show users import jobs into your application. Here are all the APIs to deal with import jobs in Impler.

#### Getting User Import Jobs

{% code overflow="wrap" %}

```
curl --location --request GET 'https://api.impler.io/v1/import-jobs/user/:externalUserId' \
--header 'accesskey: <ACCESS_TOKEN>'
```

{% endcode %}

#### Pause the User Import Job

{% code overflow="wrap" %}

```
curl --location --request GET 'https://api.impler.io/v1/import-job/user/:jobId/pause' \
--header 'accesskey: <ACCESS_TOKEN>'
```

{% endcode %}

#### Resume the User Import Job

{% code overflow="wrap" %}

```
curl --location --request GET 'https://api.impler.io/v1/import-job/user/:jobId/resume' \
--header 'accesskey: <ACCESS_TOKEN>'
```

{% endcode %}

#### Delete the User Import Job

```
curl --location --request GET 'https://api.impler.io/v1/import-job/user/:
externalUserId/:jobId' \
--header 'accesskey: <ACCESS_TOKEN>'
```

***

If you have any questions, suggestions, or comments. Feel free to reach out to us over [**Discord**](https://discord.impler.io). We’re constantly improving to deliver the best Data Importer for your product, and we value your input.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.impler.io/features/automated-import.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.