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

# Run and test a Workflow

> Execute your Workflows manually, on a schedule, or through integrations, and use the testing interface to debug each step.

Once you have [built a Workflow](/workflows/building), there are several ways to run it depending on your use case. You can also use Cassidy's testing interface to validate each step before going live.

## Run a single Workflow

Run a Workflow once with manually entered inputs. This is the usual experience for a [Manual trigger](/reference/triggers/manual); a few other trigger types use the same Run form inside Cassidy.

<Note>
  Builders can change how this page looks and which action results are highlighted from the **Interface** tab. See [Customize the Workflow run view](/workflows/interface).
</Note>

<Steps>
  <Step title="Open the Run tab">
    Open the Workflow and click the **Run** tab.
  </Step>

  <Step title="Enter inputs">
    Fill out the form fields defined by the Workflow (text, URLs, files, dropdowns, and so on).

    <Frame>
      <img src="https://mintcdn.com/cassidy/Mm6DAjguZrGyO5A4/images/workflows/run-tab-filled-inputs.png?fit=max&auto=format&n=Mm6DAjguZrGyO5A4&q=85&s=f195601629b8bd68f61b31e5883255ef" alt="Run tab with Topic, Target Audience, and optional fields filled in before running the Workflow" width="1024" height="893" data-path="images/workflows/run-tab-filled-inputs.png" />
    </Frame>
  </Step>

  <Step title="Start the run">
    Click the run button (often **Run Workflow**, unless the builder changed the label on the **Interface** tab). The Workflow runs to completion; progress appears under **Steps** as each action finishes.
  </Step>

  <Step title="Review results">
    When the run succeeds, expand **Steps** to inspect every action, and **Outputs** if the builder added highlighted values on the **Interface** tab—see [Customize the Workflow run view](/workflows/interface).

    <Frame>
      <img src="https://mintcdn.com/cassidy/Mm6DAjguZrGyO5A4/images/workflows/run-tab-completed-outputs.png?fit=max&auto=format&n=Mm6DAjguZrGyO5A4&q=85&s=9073ab019d6a9eb6658f53ef754f3472" alt="Completed run on the Run tab with Steps, Outputs, Copy Results Link, and New Run" width="830" height="1024" data-path="images/workflows/run-tab-completed-outputs.png" />
    </Frame>

    Use **Copy Results Link** to share a link to this run's results. Use **New Run** to clear the form and run again with different inputs.
  </Step>
</Steps>

<Tip>Check your previous Workflow runs and the credits they consumed by clicking **View Previous Runs** in the top-right corner of the Workflow details page.</Tip>

## Schedule a Workflow

Set a Workflow to run automatically on a recurring basis.

<Steps>
  <Step title="Use a Scheduled trigger">
    When [building your Workflow](/workflows/building#configure-the-trigger), select [**Scheduled**](/reference/triggers/scheduled) as the trigger type.
  </Step>

  <Step title="Configure the schedule">
    Set the frequency (e.g., every hour, daily, weekly) and the specific time. The Workflow runs automatically at the configured times without any manual input.

    <Frame>
      <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/scheduled-trigger-settings.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=1b7547a3e0ea67cdee5d0462e8cba893" alt="Scheduled trigger configuration showing frequency and time options" width="1484" height="575" data-path="images/workflows/scheduled-trigger-settings.png" />
    </Frame>
  </Step>
</Steps>

## Run an integrated Workflow

Trigger Workflows automatically from events in your connected tools.

<Steps>
  <Step title="Use an integration, webhook, or email trigger">
    Select an integration trigger, a [Webhook](/integrations/webhooks) trigger, or an [Email](/reference/triggers/email) trigger when building your Workflow. Available integration triggers include:

    * [Slack message](/integrations/slack/slack-message-trigger)
    * [HubSpot record created](/integrations/hubspot/record-created-trigger) / [updated](/integrations/hubspot/record-updated-trigger)
    * [Salesforce record created](/integrations/salesforce/record-created-trigger) / [updated](/integrations/salesforce/record-updated-trigger)
    * [Zendesk new ticket](/integrations/zendesk/new-ticket-trigger) / [updated ticket](/integrations/zendesk/updated-ticket-trigger)
    * [Gmail new email](/integrations/google-workspace/gmail/new-email-trigger)
    * [Outlook new email](/integrations/microsoft-365/outlook/new-email-trigger)
    * [Google Calendar event](/integrations/google-workspace/google-calendar/new-or-updated-event-trigger)
    * [Outlook Calendar event](/integrations/microsoft-365/outlook/new-calendar-event-trigger)
    * [Teams channel message](/integrations/microsoft-365/teams/new-channel-message-trigger) / [chat message](/integrations/microsoft-365/teams/new-chat-message-trigger)
    * [Gong call transcript](/integrations/gong/new-call-transcript-trigger)
    * [Zapier trigger](/integrations/zapier/zapier-trigger)
    * [Meeting ended](/reference/triggers/meeting-ended)
  </Step>

  <Step title="Connect the integration">
    Follow the prompts to authorize and configure the connected app. For webhooks, copy your unique webhook URL and configure your external system to send a POST request to it.
  </Step>

  <Step title="Workflow runs in the background">
    Once configured, the Workflow runs automatically whenever the specified event occurs. Results are logged in **View Previous Runs**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/integration-trigger-connected.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=187dea0df4bcadec614ba4e8bbbcab3a" alt="Integration trigger showing a connected app" width="1485" height="751" data-path="images/workflows/integration-trigger-connected.png" />
    </Frame>
  </Step>
</Steps>

For more on external deployment, see [sharing and deployment](/workflows/sharing-and-deployment#deploy-externally).

## Run a Workflow in chat

You can execute Workflows directly within Cassidy's chat interface in two ways:

* **Run manually from chat** -- open the Workflows panel in a chat, select a Workflow, fill in the form, and generate results without leaving the conversation. See [chatting with an Agent](/guides/chatting-with-an-agent) for details.
* **Agent calls a Workflow automatically** -- equip an [Agent](/agents/overview) with the [Call Workflow](/agents/call-workflow) capability so it intelligently decides when to run a relevant Workflow during a conversation.

## Test a Workflow

Cassidy's testing interface lets you validate your Workflow step by step before processing live data.

<Steps>
  <Step title="Open the editor">
    Navigate to your Workflow and click **Edit** in the top-right corner.

    <Frame>
      <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/workflow-edit-button.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=9c342ca96538b1de8428b71a5f970661" alt="Workflow detail page with the Edit button highlighted in the top-right corner" width="2810" height="158" data-path="images/workflows/workflow-edit-button.png" />
    </Frame>
  </Step>

  <Step title="Click Test Workflow">
    Click the **Test Workflow** button in the editor toolbar.
  </Step>

  <Step title="Enter test values and run">
    Fill in sample values for your trigger inputs and click **Run Workflow** to execute a full end-to-end test.

    <Frame>
      <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/test-workflow-inputs.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=c9dad138779de842dfca42cb3fc0d528" alt="Test Workflow panel with sample inputs filled in and the Run Workflow button" width="2850" height="1462" data-path="images/workflows/test-workflow-inputs.png" />
    </Frame>
  </Step>

  <Step title="Review outputs">
    After the run completes, examine the results displayed for each action. Click the edit icon on any action block to jump to its configuration and make adjustments.

    <Frame>
      <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/test-workflow-results.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=268cb2f0624078d571256ed00c8aad9a" alt="Test results showing output for each action in the Workflow" width="1116" height="2010" data-path="images/workflows/test-workflow-results.png" />
    </Frame>
  </Step>
</Steps>

### Granular testing options

Once you have run a full test, you can retest individual steps without re-running the entire Workflow:

| Option                    | What it does                                         | When to use it                                                |
| ------------------------- | ---------------------------------------------------- | ------------------------------------------------------------- |
| **Retest This Step Only** | Reruns a single action in isolation                  | Debugging one specific action                                 |
| **Retest From Here**      | Runs the current action and everything after it      | You changed an action that affects downstream steps           |
| **Retest To Here**        | Runs all actions up to and including the current one | The later steps work and you don't want to trigger them again |

Click the retest icon on any action block to access these options.

<Frame>
  <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/retest-options-menu.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=6fcc16b0eabdcbe0a42115c1372fce61" alt="Retest options menu on an action block showing Retest This Step Only, Retest From Here, and Retest To Here" width="1114" height="360" data-path="images/workflows/retest-options-menu.png" />
</Frame>

### Test nested actions

Workflows that use [Paths](/workflows/building#add-conditional-logic-with-paths) or Loops contain nested actions. Click into a nested action to access its individual testing options and configuration.

### Skip actions during testing

Some actions -- like sending emails or updating CRM records -- should not run during testing. Click the **...** menu on an action and toggle **Skip During Testing** to prevent it from executing in test runs. A visual indicator appears on the action block.

<Frame>
  <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/skip-during-testing-menu.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=909a58df0b0da49475d74a6dcc504ef6" alt="Action menu with the Skip During Testing toggle" width="1044" height="830" data-path="images/workflows/skip-during-testing-menu.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/skip-during-testing-indicator.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=3bebe4836928c54044a2611a5d55d110" alt="Action block showing the Skip During Testing indicator" width="1106" height="186" data-path="images/workflows/skip-during-testing-indicator.png" />
</Frame>

### Review previous test runs

Click **Previous Runs** in the test panel to see your testing history. You can review the inputs and outputs from each past test run, and click the clipboard icon to copy previous inputs into a new test.

<Frame>
  <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/previous-runs-panel.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=75e81f05c12e92b9019a419d693ebff3" alt="Previous Runs panel showing test run history" width="1108" height="780" data-path="images/workflows/previous-runs-panel.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cassidy/fKT2RiTD5Kge6TLJ/images/workflows/previous-runs-details.png?fit=max&auto=format&n=fKT2RiTD5Kge6TLJ&q=85&s=a4110137df9d414767f63b31a1ee67ad" alt="Previous Runs details showing inputs and outputs from a past test run" width="1112" height="416" data-path="images/workflows/previous-runs-details.png" />
</Frame>

## Next steps

<CardGroup cols={2}>
  <Card title="Process data in bulk" icon="table" href="/workflows/bulk-runs">
    Import datasets and run your Workflow at scale.
  </Card>

  <Card title="Share and deploy" icon="share-nodes" href="/workflows/sharing-and-deployment">
    Manage permissions and deploy via webhooks.
  </Card>

  <Card title="Analyze data" icon="chart-bar" href="/workflows/advanced/data-analysis">
    Use Code Execution & File Creation to generate insights, charts, and reports from files.
  </Card>

  <Card title="Set fallback values" icon="shield-halved" href="/workflows/advanced/fallback-values">
    Keep your Workflow running even when individual actions fail.
  </Card>

  <Card title="Hide actions from results" icon="eye-slash" href="/workflows/advanced/hide-actions-from-results">
    Show only the most relevant outputs to end users.
  </Card>
</CardGroup>
