MindStudio Docs
  • Get Started
    • Overview
    • MindStudio Chrome Extension
    • Quickstart Guide
    • What is an AI Agent?
    • AI Agent Use Cases
  • Free vs. Paid AI Agents
  • Building AI Agents
    • Editor Overview
    • Workflow Generator
    • Writing Prompts
      • Templating
    • AI Models
    • Variables
      • Working with JSON
      • Using Handlebars Templating
    • Dynamic Variables
    • Data Sources
    • Automations
      • Start Block
      • Generate Text Block
      • Generate Image Block
      • Generate Chart Block
      • Generate Asset Block
      • Display Content Block
      • Text to Speech Block
      • Analyze Image Block
      • User Input Block
      • User Context Block
      • Query Data Block
      • Run Function Block
      • Scrape URL Block
      • Extract Text from File Block
      • Post to Slack Block
      • Menu Block
      • Logic Block
      • Checkpoint Block
      • Jump Block
      • Run Workflow Block
      • Terminator Block
    • Integrations
      • Search Bluesky Posts
      • Scrape Facebook Page
      • Scrape Meta Threads Profile
      • Scrape Instagram Comments
      • Scrape Instagram Mentions
      • Scrape Instagram Posts
      • Scrape Instagram Profile
      • Scrape Instagram Reels
      • Create LinkedIn Post
      • Create X Post
      • Search X Posts
      • Search Google
      • Search Google Images
      • Search Google Trends
      • Search Google News
      • Create Google Doc
      • Fetch Google Doc
      • Update Google Doc
      • Create Google Sheet
      • Fetch Google Sheet
      • Update Google Sheet
      • Enrich Company via Domain
      • Find Contact Email for Website
      • Find Email
      • Verify Email
      • Enrich Person via Email
      • Fetch YouTube Captions
      • Fetch YouTube Channel
      • Fetch YouTube Comments
      • Fetch YouTube Video
      • Search YouTube
      • Search YouTube Trends
      • Create Notion Page
      • Update Notion Page
      • Apify
      • Run Scenario
      • Post to Slack
      • HTTP Request
      • Run Node
      • Create Contact
      • Add Note
      • Send Email
      • Send SMS
    • Publishing & Versioning
  • Embedding AI Agents
  • Using Webhooks
  • Workspace Management
    • Workspace Overview
    • Workspace Settings
    • Usage Explorer
    • Billing Settings
    • Account Settings
    • Team Settings & Access Controls
  • Test & Evaluate
    • Testing Suite Overview
    • Evaluations
    • Profiler
    • Debugger
  • Integration Guides
    • Zapier + MindStudio
    • Make.com + MindStudio
    • n8n + MindStudio
  • Developers
    • API Reference
    • NPM Package
    • Custom Workflow Functions
  • Additional Resources
    • Glossary
    • Allowing Access to Mindstudio From Your Network
  • Solutions
    • MindStudio Solutions Partners
    • MindStudio For Developers
    • MindStudio for Enterprises
Powered by GitBook
On this page
  • Prerequisites
  • How to find your Agent ID
  • How to get an API Key
  • How to create Launch Variables
  • Step-by-Step Setup in n8n
  • Test & Debug
  • Common issues:
Export as PDF
  1. Integration Guides

n8n + MindStudio

Integrate MindStudio AI Agents with n8n

Last updated 8 days ago

MindStudio Agents can be triggered directly from using an HTTP Request node to run custom workflows. This guide walks you through the full setup.

Prerequisites

Before you start:

  • You must have a MindStudio account with a published AI Agent.

  • You'll need your Agent ID and an API key from the MindStudio Developer Portal.

  • Your agent must have Launch Variables setup in the Start Block.

  • (optional) Set your Terminator Block to the End behavior to output JSON

How to find your Agent ID

  1. Open the Agent you'd like to call via API

  2. In the Editor, click the top folder to open the Agent Settings

  3. On the Metadata tab, you'll find the Agent ID at the bottom.

  4. Click on the Agent ID to copy it to your clipboard.

How to get an API Key

  1. Click on "Create Key"

  2. Name your Key

  3. Click on the key to copy it to your clipboard

How to create Launch Variables

  1. Open the Agent you'd like to call via API

  2. In the automations tab, click on the Start Block

  3. Make sure your Run Mode is set to On-Demand

  4. At the top of the configuration panel click to add new launch variables

Step-by-Step Setup in n8n

1. Add an HTTP Request Node

  • Click the “+” button in n8n

  • Search for and select HTTP Request

  • Double-click on the node to open configuration settings

2. Click on Import cURL button at the top right of the

3. Paste in this cURL command

curl -X POST https://v1.mindstudio-api.com/developer/v2/agents/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
  

5. Click on IMPORT

6. Once imported, change the Specify Body setting to Using JSON

7. Paste the following code into the JSON area

{{
{
    "workerId": "YOUR_AGENT_ID",
    "variables": {
      "LAUNCH_VARAIBLE_1": VALUE_1,
      "LAUNCH_VARAIBLE_2": VALUE_2,
    },
    "workflow": "YOUR_WORKFLOW_NAME.flow"
  }
}}

8. In the JSON, replace the following with your own data:

  • VALUES - These values will come from your n8n instance. You can clack and drag any input from the left into the JSON area to bring it into your code. When you drag an input in, it should look like this: $json['Value'] . If you are not using inputs from n8n, then make sure to wrap your value in quotation marks like this: "value"

  • YOUR_WORKFLOW_NAME - The name of the workflow you want to trigger (Ex: Main.flow)


Test & Debug

Run the workflow manually with sample data. If there’s an error, check the HTTP Response Code and body message. You may also consider using n8n's built in assistant to help debug.

Common issues:

  • Invalid API Key → Ensure your key is copied correctly from MindStudio.

  • Invalid Agent ID → Only use published Agent IDs.

  • Missing variables → Ensure all required launch variables are included.

Go to

Make sure to change YOUR_API_KEY -

YOUR_AGENT_ID -

LAUNCH_VARIABLES -

https://app.mindstudio.ai/developer/api-keys
See section above get your API key
See section above to get your AGENT ID
See section above to learn how to create launch variables
n8n
Agent ID in Metadta Tab
Create an API Key
Creating Launch Variables
Import cURL Button
Send Body Section