n8n Integration Guide: Automate NeuroViz with n8n Workflows

API access requires a Pro Plus or Agency plan. Sign up at app.neuroviz.ai and upgrade. You also need credits — the same credits used on the web platform. See the full API documentation for endpoint reference.

Use n8n Cloud (easiest — includes a public URL for webhooks) or self-host n8n on your own server. This guide works with both.

The NeuroViz API accepts images via URL. Your image needs to be hosted somewhere publicly accessible — Google Drive (with sharing on), Dropbox, S3, your Shopify CDN, or any direct image link.

Go to app.neuroviz.ai and sign in.

In the left sidebar, click API.

Click Create New Key. Copy and save it immediately — you will not see the full key again after this screen.

Go to Settings (gear icon), click Credentials, then Add Credential.

Search for Header Auth and select it.

Set exactly these three fields:

Create a new workflow. Add a Webhook node with:

• HTTP Method: POST
• Path: neuroviz-result
• Respond: Immediately

n8n generates a public URL like:

https://your-n8n.app.n8n.cloud/webhook/neuroviz-result

Use this as the webhook_url in your submission request in Workflow 1.

Success payload:

{
  "run_id": "abc123-def456-ghi789",
  "status": "SUCCESS",
  "output_url": "https://cdn.neuroviz.ai/outputs/result.png",
  "thumbnail": "https://cdn.neuroviz.ai/outputs/result_thumb.png"
}

Failure payload:

{
  "run_id": "abc123-def456-ghi789",
  "status": "FAILURE",
  "error": "Invalid image URL or image could not be downloaded"
}

Condition: {{ $json.body.status }} equals SUCCESS. The true branch downloads the image; the false branch alerts you.

On the success branch, add an HTTP Request node:

• Method: GET
• URL: {{ $json.body.output_url }}
• Response Format: File

Pass the downloaded file to Google Drive, S3, email, Slack, or wherever you need it.

Click Publish in the top right. Production webhooks only fire when the workflow is published and active.

Same as Workflow 1. You can omit the webhook_url field entirely.

Add a Wait node to give NeuroViz time to process before the first status check.

• Method: GET
• URL: https://app.neuroviz.ai/api/v1/runs/{{ $('Submit Photo').item.json.run_id }}

Status will be IN_QUEUE, IN_PROGRESS, SUCCESS, or FAILED.

If SUCCESS, download from output_url. Otherwise loop back to the Wait node. Stop after 10 attempts to avoid infinite loops.

Create a Google Sheet or CSV with columns product_name and image_url.

Use a Google Sheets or Spreadsheet File node.

Add Loop Over Items with batch size 1.

Reference the row data in the JSON body:

{
  "app_id": "YOUR_APP_ID",
  "parameters": {
    "image_input": "{{ $json.image_url }}"
  },
  "webhook_url": "https://your-n8n.app.n8n.cloud/webhook/neuroviz-result"
}

A Wait node set to 2-5 seconds after each submission prevents rate limiting.

• Header Name must be Authorization (capital A)
• Header Value must start with Bearer (capital B, followed by a single space)
• No accidental extra spaces, tabs, or line breaks

• Missing app_id, parameters, or webhook_url
• Image URL is a preview page, not the raw file
• JSON syntax error (missing quotes, trailing comma)

• Is the receiver workflow published (active)?
• Are you using the Production URL, not the Test URL?
• Self-hosted: is your server publicly reachable from the internet?

Not enough credits. Check with GET /api/v1/balance or buy more at app.neuroviz.ai.

Paste the URL in your browser — you should see the image directly, not an HTML page.

• Google Drive: use https://drive.google.com/uc?id=FILE_ID
• Dropbox: change ?dl=0 to ?dl=1

n8n Cloud has a 100-second execution timeout. NeuroViz fires the webhook after processing completes, so this is rarely an issue. Keep any post-processing logic (downloads, notifications) under 100 seconds total.