For the complete documentation index, see llms.txt. This page is also available as Markdown.

Connectors

Connect your tools once and pull data and assets from where they already live.

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, 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.

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.


Add connectors

Quickstart

  1. Open Settings 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.


Available connectors

Connector
Type
What it does

Google Drive

Files

Pull images & videos straight from your folders.

Dropbox

Files

Pull assets from shared Dropbox folders.

Google Sheets

Tables

Pull rows from your spreadsheets.

Airtable

Tables

Pull records from your Airtable bases.

Shopify

Files & Tables

Pull products and media from your Shopify store. More here.


How connectors work

You sign in directly with the provider, so Pletor never sees your password. These connections are handled by Pipedream, 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.

If nothing happens when you click Connect, check that your browser isn't blocking popups for Pletor.

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.

For Google Drive, make sure the Drive checkbox is ticked on Google's consent screen — without it, Pletor can't access your files.

Does Pletor keep my files or tables in sync with the source?

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

What data can Pletor access?

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.

What happens to my flows if I disconnect a tool?

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


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.

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)

  • 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

  • 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

  • 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

"Access denied for products field" or the preview grid is empty

Your app has no access scopes granted (Shopify docs on access scopes). In the Dev 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.

I added scopes but nothing changed

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.

Shopify says the redirect URI is not authorized / not whitelisted

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. 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.

I can see products but not media (or vice versa)

One of the two scopes is missing. Check that bothread_filesandread_productsare declared (scope reference), then release + reconnect.

Nothing happens when I click Connect

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

Last updated