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

# n8n

> Connect Skyvern to n8n's open-source automation platform. Dispatch tasks and agents, retrieve results, and integrate browser automations into any n8n workflow.

Connect Skyvern to n8n's open-source automation platform. Trigger browser automations from any workflow, or pipe Skyvern's results into downstream nodes.

## Available Operations

* **Task → Dispatch a Task**: Run a browser automation with a prompt
* **Task → Get a Task**: Retrieve results from a previously run task
* **Agent → Dispatch an Agent Run**: Run a pre-built Skyvern agent with parameters
* **Agent → Get an Agent Run**: Retrieve results from a previously run agent

## Setup

<Steps>
  <Step title="Install the Skyvern node">
    Create a new workflow or edit an existing one, click **+**, search for "Skyvern", and click *Install* → *Add to workflow*.

    <Frame>
      <video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/skyvern/9qHw5n1YDp_Aq14I/images/n8n/n8n1.mp4?fit=max&auto=format&n=9qHw5n1YDp_Aq14I&q=85&s=0628277a7fc46b2f1bba731abfbdc61d" data-path="images/n8n/n8n1.mp4" />
    </Frame>
  </Step>

  <Step title="Connect your account">
    Click *Select credential* → "Create new credential" and paste your API key from [Settings](https://app.skyvern.com/settings/).
  </Step>

  <Step title="Configure">
    Fill in the fields for your chosen operation. See the field reference below.
  </Step>

  <Step title="Test">
    Run the workflow and monitor progress in your [Skyvern dashboard](https://app.skyvern.com).
  </Step>
</Steps>

## Field reference

### Dispatch a Task

<Frame>
  <img src="https://mintcdn.com/skyvern/9qHw5n1YDp_Aq14I/images/n8n/n8n2.png?fit=max&auto=format&n=9qHw5n1YDp_Aq14I&q=85&s=1d2f1cc1946e46b3c169643be8d07d5f" alt="Configure Dispatch a Task fields in n8n" width="2638" height="1700" data-path="images/n8n/n8n2.png" />
</Frame>

* **User Prompt** (required): What Skyvern should do
* **URL**: The starting page. If omitted, Skyvern navigates based on the prompt.
* **Webhook Callback URL**: URL to notify when the task finishes

Under **Task Options**:

* **Engine**: Defaults to **Skyvern 1.0**.
  * **Skyvern 1.0**: Simple, single-step tasks
  * **Skyvern 2.0**: Existing V2 workflows or explicitly requested V2 task runs
  * **OpenAI CUA** / **Anthropic CUA**: Third-party computer-use agents

### Dispatch an Agent Run

<Frame>
  <img src="https://mintcdn.com/skyvern/9qHw5n1YDp_Aq14I/images/n8n/n8n3.png?fit=max&auto=format&n=9qHw5n1YDp_Aq14I&q=85&s=e497f2375c0d4381bbb51b492f909da9" alt="Configure Dispatch an Agent Run fields in n8n" width="2722" height="2150" data-path="images/n8n/n8n3.png" />
</Frame>

First, create your agent in the [Skyvern UI](https://app.skyvern.com).

* **Agent Name or ID** (required): Select from the dropdown or specify an ID with an expression
* **Agent Run Parameters**: Loaded dynamically from the selected agent
* **Webhook Callback URL**: URL to notify when the agent finishes

### Get a Task

<Frame>
  <img src="https://mintcdn.com/skyvern/9qHw5n1YDp_Aq14I/images/n8n/n8n5.png?fit=max&auto=format&n=9qHw5n1YDp_Aq14I&q=85&s=b4a2cc4bbb50a290eb44568e76971689" alt="Enter Task ID field in n8n" width="2818" height="1576" data-path="images/n8n/n8n5.png" />
</Frame>

* **Task ID** (required): The ID of the task run

### Get an Agent Run

<Frame>
  <img src="https://mintcdn.com/skyvern/9qHw5n1YDp_Aq14I/images/n8n/n8n4.png?fit=max&auto=format&n=9qHw5n1YDp_Aq14I&q=85&s=da47762fba9147f5821ff3c37d410e0f" alt="Enter Agent Run ID field in n8n" width="2818" height="1576" data-path="images/n8n/n8n4.png" />
</Frame>

* **Agent Name or ID** (required): Select the agent from the dropdown
* **Agent Run ID** (required): Starts with `wr_`

## Next steps

<CardGroup cols={2}>
  <Card title="Build Agents" icon="diagram-project" href="/cloud/building-agents/manage-agents">
    Create reusable multi-step automations in Skyvern
  </Card>

  <Card title="Use Webhooks" icon="webhook" href="/developers/going-to-production/webhooks">
    Get notified when tasks complete
  </Card>
</CardGroup>