> For the complete documentation index, see [llms.txt](https://docs.pletor.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pletor.ai/automate/connectors.md).

# Connectors

Connectors link Pletor to the apps your team already works in, so you can bring images, videos, spreadsheet rows, and products into your agents without downloading and re-uploading anything.

## Use cases

#### Import files into a Batch

In [Batch](/automate/batch.md), click **Connect** in the header (or **Import** on a column) and pick a source. Choose your Google Drive, Dropbox, or Shopify account, browse your files — with search, sorting, and Drive shortcuts like **My Drive**, **Shared with me**, **Recent**, and **Starred** — then select the files to add.

<figure><img src="/files/QFau3576VsKxJIOD6leO" alt=""><figcaption></figcaption></figure>

Imported files are copied into your workspace as assets. Imports run in the background, so large files show a loading state for a moment before they're ready.

#### Import rows into a Batch

Pick a tables source instead: choose a spreadsheet in Google Sheets, a base and table in Airtable, or your Shopify **Products** table — then preview the rows and import them into your Batch grid.

The Shopify Products table gives you each product's title, description, vendor, product type, tags, price, image URL, handle, and status.

If a column contains links to images or videos, those links are imported as media assets automatically, ready to use in your runs.

<figure><img src="/files/VH4YGc4gMTYoempd6Xbm" alt=""><figcaption></figcaption></figure>

***

## Add connectors

#### Quickstart

1. Open [**Settings**](https://app.pletor.ai/?settings=connectors) and go to **Connectors**.
2. Find the tool you want and click **Connect**.
3. A popup opens on the provider's own sign-in page. Log in and grant access.
4. Once the popup closes, the card shows **Connected** — you're done.

<figure><img src="/files/z52mw3nSCAG5vuzJ70pP" alt=""><figcaption></figcaption></figure>

***

#### Available connectors

<table><thead><tr><th width="163.796875">Connector</th><th width="150.625">Type</th><th width="255.32421875">What it does</th></tr></thead><tbody><tr><td><strong>Google Drive</strong></td><td>Files</td><td>Pull images &#x26; videos straight from your folders.</td></tr><tr><td><strong>Dropbox</strong></td><td>Files</td><td>Pull assets from shared Dropbox folders.</td></tr><tr><td><strong>Google Sheets</strong></td><td>Tables</td><td>Pull rows from your spreadsheets.</td></tr><tr><td><strong>Airtable</strong></td><td>Tables</td><td>Pull records from your Airtable bases.</td></tr><tr><td><strong>Shopify</strong></td><td>Files &#x26; Tables</td><td>Pull products and media from your Shopify store. <a href="#connect-your-shopify-store">More here</a>.</td></tr></tbody></table>

***

#### How connectors work

You sign in directly with the provider, so Pletor never sees your password. These connections are handled by [Pipedream](https://pipedream.com/), our secure connection partner, you may see its name in the sign-in window, and your credentials stay with Pipedream rather than being stored by Pletor.

Connections are shared at workspace level, with per-user authentication. Access is **read-only**: Pletor imports from your sources and never writes back to them.

{% hint style="info" %}
If nothing happens when you click **Connect**, check that your browser isn't blocking popups for Pletor.
{% endhint %}

Imports are **one-time copies**, not live links. Once a file or row is imported, it lives in your workspace as a Pletor asset and won't change if the original does. To pick up changes from the source, just import again.

A few practical limits:

* Files up to **40 MB** each
* Up to **500 rows** per table import
* Up to **1,000 media links** imported from a table at once

***

#### Disconnecting and reconnecting

To disconnect a tool, open **Settings → Connectors** and click **Disconnect** next to the account. Disconnecting takes effect immediately.

Everything you've already imported stays in your workspace — disconnecting only stops new imports from that source.

{% hint style="info" %}
For Google Drive, make sure the Drive checkbox is ticked on Google's consent screen — without it, Pletor can't access your files.
{% endhint %}

<details>

<summary>Does Pletor keep my files or tables in sync with the source?</summary>

No. Every import is a snapshot taken at that moment. Re-import whenever you want the latest version.

</details>

<details>

<summary>What data can Pletor access?</summary>

Only what's needed to browse and import: your files and folders for file connectors, and your spreadsheets, bases, or product catalog for table connectors. Shopify access is strictly read-only and limited to products and media — never customer or order data. You can revoke access at any time by disconnecting in Pletor or from the provider's own security settings.

</details>

<details>

<summary>What happens to my flows if I disconnect a tool?</summary>

Assets and rows you already imported keep working — they're stored in your workspace. Only new imports from that source require reconnecting.

</details>

***

## Connect your Shopify store

Shopify asks for couple of extra details before the sign-in popup.

> Connecting takes about 10 minutes and requires creating a small custom app in Shopify: this is Shopify's standard way of granting another tool secure, read-only access to your store.&#x20;

#### Step by step

* Click **Connect** on the Shopify card.
* Enter your shop ID. If your store's URL is `https://my-shop-name.myshopify.com`, your shop ID is `my-shop-name`. (If you don't know your shop ID you can find it here: [Shopify admin → Settings → Domains](https://admin.shopify.com/settings/domains))

<figure><img src="/files/eaumOFpadoazAGyOB1Vm" alt=""><figcaption></figcaption></figure>

* Access the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard/)
* **Make sure you are signing to the correct store on Shopify. You can find the current store on the top right of the Shopify Dev Dashboard**
* Create the app from the Create app button at the bottom of the page&#x20;

<figure><img src="/files/AO7xszouLuCiFerlFS5R" alt=""><figcaption></figcaption></figure>

* In the Create App form, only two fields are necessary to fill in **API access,** copy the following in the correct input:
  * Scopes:
    * `read_files,read_products`&#x20;
  * Redirect URLs:
    * [`https://api.pipedream.com/connect/oauth/oa_g5KiBG/callback`](https://api.pipedream.com/connect/oauth/oa_g5KiBG/callback)&#x20;
* The form should look like the following screenshot:

<figure><img src="/files/TBZgi4H7ABB8ppOmqGkQ" alt=""><figcaption></figcaption></figure>

* Then "Release" the app.
* Back in Pletor, from the Pipedream when prompted, enter
  * **Shop ID** — from the 1st Step (e.g. `my-shop-id`)
  * **Client ID** (from your app's Settings section *see screenshot below*)
  * **Client Secret**

<figure><img src="/files/tvmFRDrtAT1EXXX2k5xm" alt=""><figcaption></figcaption></figure>

* You might be prompted twice by Shopify
  * First to install the app you just created in your shop
  * Second, to validate the connection to Pletor

> Pletor requests **read-only** access to your products and files, it never sees your customers, orders, or payment data, and it never changes anything in your store.

#### Troubleshooting

<details>

<summary>"Access denied for products field" or the preview grid is empty</summary>

Your app has no access scopes granted ([Shopify docs on access scopes](https://shopify.dev/docs/api/usage/access-scopes)). In the [Dev Dashboard](https://dev.shopify.com/dashboard):

1. Add `read_files,read_products` to the app's access scopes
2. **Release a new app version**
3. In Pletor, **disconnect and reconnect** Shopify

All three steps are required — the new scopes are only granted when the app is re-authorized.

</details>

<details>

<summary>I added scopes but nothing changed</summary>

Scope changes never apply to an existing connection. Release a new app version, then disconnect and reconnect in Pletor so the store re-installs the app with the new permissions.

</details>

<details>

<summary>Shopify says the redirect URI is not authorized / not whitelisted</summary>

This happens at the very last step, when Shopify checks the callback against your app's configuration. Check these three things in order:

1. **Did you release the app version?** Redirect URL changes only take effect after clicking **Release** in the Dev Dashboard — saving the form is not enough. This is the most common cause.
2. **Is the URL an exact match?** It must be exactly `https://api.pipedream.com/connect/oauth/oa_g5KiBG/callback` — no trailing slash, no extra spaces from copy-paste — and it must be in the **Redirect URLs** field, not the App URL field.
3. **Was the app created in the right place?** It must be created in the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Apps created from the Shopify admin under *Settings → Apps → Develop apps* don't support this connection flow.

After fixing, release a new version and retry the connection from Pletor.

</details>

<details>

<summary>I can see products but not media (or vice versa)</summary>

One of the two scopes is missing. Check that bothread\_filesandread\_productsare declared ([scope reference](https://shopify.dev/docs/api/usage/access-scopes)), then release + reconnect.

</details>

<details>

<summary>Nothing happens when I click Connect</summary>

Your browser is blocking the sign-in popup. Allow popups for app.pletor.ai and try again.

</details>