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

# Workflow Builder Quick Start Guide

> A walk through of how to create a simple end to end data workflow

# Workflows Quick Start Guide

<Note>
  **Prerequisites:** Complete the [Extraction Agent Quickstart](/quickstart) first and have at least one extraction agent ready before following this guide.
</Note>

## Overview

The Workflow Builder connects Cloudsquid to thousands of tools and services, allowing you to automate end-to-end data processes. Workflows are only available for our paid users. If you're interested in a Free Trial you can fill out the form that will appear when you click on this feature.

In this quick start, we'll build a workflow that:

1. Starts with an email trigger that captures an attached invoice.
2. Processes the attachment through an Extraction Agent, which is an Action node
3. Sends the extracted data to a Google Sheet.

***

### 1. Create a Workflow

Workflow are containers for your automated process.

1. In the left-hand panel, go to **Workflows**.
2. Click **Create Workflow**.
3. Give it a clear, descriptive name so you and your team can identify it later and hit Save

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.01.22.gif?s=567773b4f662b6b1a2def937775f328a" alt="Recording2025 08 13at16 01 22 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.01.22.gif" />

***

### 2. Add an Email Trigger

Email is one of the most common sources of incoming documents for a business. The Workflow Builder lets you build email Trigger in two ways:

* **Direct integrations** with Outlook or Gmail, where you set conditional triggers.
* **Managed Cloudsquid inbox**, which generates a unique email address for automated ingestion.

For this quick start, we'll use the managed inbox:

1. Click **Add Trigger** → choose the **Email** node from the Cloudsquid native nodes.

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.03.19.gif?s=228937871223b1852b0f27890ca83c49" alt="Recording2025 08 13at16 03 19 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.03.19.gif" />
2. In the Email node settings, click **Save and Continue** to generate your email address.

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.04.55.gif?s=c528bbb6670e949449320c109435ae1c" alt="Recording2025 08 13at16 04 55 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.04.55.gif" />
3. Copy this address and send a test email to it from your separate email account with an attachment (e.g., an invoice PDF).
4. After 20–30 seconds, the email appears in the node's **Outputs**. Click the "Email" output to see available data.

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.08.34.gif?s=823d7a887a81a65265d03c25e0c257da" alt="Recording2025 08 13at16 08 34 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.08.34.gif" />

***

### 3. Add an Extraction Agent Action

Extraction Agents process and structure your document data. You should have one ready from the [Extraction Agent Quick Start Guide](/quickstart).

1. Click the **+** after your trigger → choose **Extraction Agent** from the native nodes.

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.11.30.gif?s=a89cfedcd210cbf7d3dc8ef609a5b3f5" alt="Recording2025 08 13at16 11 30 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.11.30.gif" />
2. In the settings:
   * **Extraction Agent ID** – choose your pre-created agent.
   * **File content** – in the data viewer, search "attachments" and select the `contentUrl` value.

     <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.23.01.gif?s=9174d379cae49060eaddf6c0027965e5" alt="Recording2025 08 13at16 23 01 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.23.01.gif" />
   * **Filename** – search "attachments" and select the `filename` value.

     <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.24.09.gif?s=9ad80c355d997841c05d1c574b4c6fcc" alt="Recording2025 08 13at16 24 09 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.24.09.gif" />
   * **Filetype** – select `uri` since we access this file via its URL link
   * **Mimetype** – choose the correct type, e.g., `application/pdf`.
   * **AI Model** – choose **cloudsquid-flash** for speed and lower cost.

     <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.26.41.gif?s=b10e158d6abb11a88996cfb939cedd79" alt="Recording2025 08 13at16 26 41 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.26.41.gif" />
3. Click **Test run Node** to verify extraction. Results will appear in the OUTPUT viewer.

***

### 4. Add a Google Sheets Action

We'll now send the extracted data to Google Sheets:

1. Click the **+** after the Extraction Agent node → search for **Google Sheets**.
2. Choose the **Upsert Row** action (adds new rows without overwriting existing data).

   <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.33.38.gif?s=c760d2f0fa537fb2f3bce53f7f24a2db" alt="Recording2025 08 13at16 33 38 Gi" width="1920" height="1080" data-path="imagesquickstart/Addfilesworkflow/Recording2025-08-13at16.33.38.gif" />
3. Create a blank Google Sheet (e.g., "invoice demo") in your Google account.
4. In the Google Sheets node settings:
   * **Authenticate** with your Google account.
   * Select the Drive, Spreadsheet, and Worksheet.

     <img src="https://mintcdn.com/cloudsquid/hNL3e3oo6NRkY-Va/imagesquickstart/Addfilesworkflow/Screenshot2025-08-13at16.42.43.png?fit=max&auto=format&n=hNL3e3oo6NRkY-Va&q=85&s=29eeef697d1df1d68aac619ed380bb97" alt="Screenshot2025 08 13at16 42 43 Pn" width="1920" height="936" data-path="imagesquickstart/Addfilesworkflow/Screenshot2025-08-13at16.42.43.png" />
   * For **Insert – Cells / Column Values**:
     * Click **Manual List** and use the data viewer to pick fields from the extracted file (e.g., vendor name, invoice amount, invoice number).
     * Click **Add** after each field selection.
   * **Key Column** – enter `A` so rows append from the first column.
5. Click **Test run Node** to push data into the sheet, then check Google Sheets for results.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Outlook" icon="envelope" href="/connect_to_outlook_guide">
    Route emails from your Outlook mailbox directly into Cloudsquid projects.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Trigger extraction and reconciliation programmatically via the REST API.
  </Card>
</CardGroup>
