> ## Documentation Index
> Fetch the complete documentation index at: https://help.csvbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedream

> Import your CSV or Excel data directly into your Pipedream workflows with CSVbox.

The Pipedream integration triggers your Pipedream automations in real time whenever a spreadsheet import is submitted. Use it to connect data to your APIs, CRMs, or databases without writing custom code.

## How it works

CSVbox sends the imported CSV data to your selected Pipedream workflow as soon as a user submits it. Each import becomes a new event in Pipedream, where you can process or forward the data to hundreds of apps.

### Example workflow

1. A user uploads a CSV → CSVbox validates it and sends the data to Pipedream.
2. The Pipedream trigger receives the event.
3. The workflow inserts rows into a database, sends Slack alerts, or posts data to your API.

## Setup instructions

<Steps>
  <Step title="Choose Pipedream as your destination">
    In your CSVbox **Sheet Settings**, select **Pipedream** as the destination and click **Save**.
  </Step>

  <Step title="Create a Pipedream trigger">
    1. Log in to your [Pipedream account](https://pipedream.com/).
    2. Create a **new workflow**.
    3. When prompted to select a trigger source, choose **CSVbox** → **New Import**.

    <Frame>
      <img src="https://mintcdn.com/csvbox-io/gyjvlPdP5mzE2jo9/images/1trigger.png?fit=max&auto=format&n=gyjvlPdP5mzE2jo9&q=85&s=400ab70abb1a993cc952b6f2e6972646" alt="CSVbox New Import trigger in Pipedream" width="1220" height="586" data-path="images/1trigger.png" />
    </Frame>
  </Step>

  <Step title="Connect CSVbox to Pipedream">
    In the trigger setup screen, paste your CSVbox **API Key** and **API Secret Key**. You can find these under **CSVbox Dashboard** → **Account Settings** → **API Keys**.

    <Frame>
      <img src="https://mintcdn.com/csvbox-io/gyjvlPdP5mzE2jo9/images/connect-csvbox.png?fit=max&auto=format&n=gyjvlPdP5mzE2jo9&q=85&s=b7cb6f19322e0edb02a0f74a5b00c871" alt="Connect CSVbox account in Pipedream" width="1021" height="539" data-path="images/connect-csvbox.png" />
    </Frame>
  </Step>

  <Step title="Select your sheet">
    In the **Trigger Settings** window in Pipedream, choose the **Sheet Name** you want to connect from the dropdown. Click **Save and continue** to confirm.

    <Frame>
      <img src="https://mintcdn.com/csvbox-io/l4j5cgTPiOdRvWQ3/images/select-sheet.png?fit=max&auto=format&n=l4j5cgTPiOdRvWQ3&q=85&s=36919f89838f07e2350d590f575aba8c" alt="Select sheet in Pipedream trigger settings" width="861" height="586" data-path="images/select-sheet.png" />
    </Frame>
  </Step>

  <Step title="Verify the connection">
    Return to **CSVbox** → **Sheet Settings** → **Destination**. The **Pipedream Connection** now shows as **successful**.

    <Frame>
      <img src="https://mintcdn.com/csvbox-io/gyjvlPdP5mzE2jo9/images/connection-successful.png?fit=max&auto=format&n=gyjvlPdP5mzE2jo9&q=85&s=d3944dc890aae74a527bdb5feed71e02" alt="Pipedream connection successful" width="983" height="857" data-path="images/connection-successful.png" />
    </Frame>
  </Step>

  <Step title="Test the importer">
    * Upload a sample CSV using your importer.
    * Pipedream instantly receives the data as an event payload.
    * You can view the incoming event in your Pipedream workflow's **Event** tab.

    <Note>
      After making changes in your Pipedream workflow (such as reconnecting CSVbox or editing the trigger), wait **a few seconds** before testing from CSVbox. It can take a short time for Pipedream to **propagate configuration updates** across their servers.
    </Note>
  </Step>
</Steps>

## Common use cases

* **Sync leads to your CRM** (HubSpot, Salesforce, Pipedrive, etc.)
* **Insert or update records** in databases (PostgreSQL, MySQL, Supabase, Airtable)
* **Send notifications** on Slack, Discord, or Email
* **Transform or enrich data** before passing it to another service


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.