• SUCCESS
  • LOGIC
  • ERROR
  • HUMAN

How to test backend flows with JSON payloads with your AI

Connect Fastn once. After that, your agent can trigger specific workflows and pass custom data to check your logic.

Ask AI about this page

Short answer

How can I use my AI to test Fastn flows with JSON?

You tell your agent to run a specific workflow using a JSON payload. It uses the connector to send that data to Fastn, which triggers your backend logic. You'll see the results of the flow immediately in your chat.

Where every result lands.

The outcomes of your tests

Depending on how you run the test, your AI handles the execution and the feedback.

SUCCESS

Flow execution complete

The AI runs your logic. You get the direct output from the Fastn flow in your chat window.

LOGIC

Workflow structure check

Your agent pulls the current setup of a workflow. This lets you verify that the flow is configured correctly before you send data.

ERROR

Failed payload tests

If your JSON doesn't match what the flow expects, the AI reports the error. You can then tweak the payload and try again.

HUMAN

Manual logic adjustment

If a flow fails due to a broken node or bad configuration, the AI can't fix the Fastn setup itself. You'll need to jump into the Fastn editor to repair the workflow.

The workflow

What your AI does when the test arrives.

The AI acts as the bridge between your chat interface and your Fastn backend.

  1. Identify the target

    Your agent looks up the specific workflow you want to test to ensure it exists and is ready.

    get_workflow

  2. Prepare the payload

    The AI formats your natural language instructions into a valid JSON object that matches your flow's requirements.

    get_workflow

  3. Trigger the flow

    The agent sends the JSON data to Fastn to start the execution process.

    execute_flow

  4. Report results

    The AI parses the response from the execution and tells you if the backend logic worked as intended.

    execute_flow

Try it

Copy these to start.

Use these prompts to begin testing your flows.

Starting points

Swap out the workflow names and the JSON keys to match your actual Fastn setup.

Fastn Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_wa4bKnlUgLKkNcgy1RPaz1zwlTmtw2evOT0C54sb/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Fastn capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "fastn-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_wa4bKnlUgLKkNcgy1RPaz1zwlTmtw2evOT0C54sb/mcp"
    }
  }
}
Copy into chat04

  • Run the 'user_signup' flow in Fastn using this JSON: {"email": "test@example.com", "name": "John"}

  • Get the details for the 'order_processing' workflow so I can see its structure.

  • Execute the 'webhook_test' flow with a payload containing a custom ID of 12345.

  • Check the 'data_sync' workflow to see how it is currently configured.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Fastn once, then ask.

Just link your account once. Your credentials stay encrypted, and you can start testing flows immediately through your preferred AI client.

Connect Fastn to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my Fastn workflow nodes?

    No. The AI can only trigger existing flows or read their structure. It cannot modify the logic inside Fastn.

  • 02

    Does the AI create new workflows?

    No. It can only interact with workflows that already exist in your Fastn account.

  • 03

    Can I test complex nested JSON objects?

    Yes. You can provide any valid JSON structure in your prompt, and the AI will pass it to the flow.

  • 04

    What happens if the JSON is malformed?

    The execution will fail, and your AI will report the error returned by Fastn.

  • 05

    Can the AI see my Fastn API keys?

    No. Your credentials are managed securely by Vinkius and are never exposed to the AI model.

  • More questions about Fastn? The Connector page answers them. See everything the Fastn Connector can do

Connect Fastn to Claude, Cursor, ChatGPT & more