Integration Guide

Automate interviews with n8n

Create interview topics from any n8n trigger and receive structured results in your workflow when participants finish — no manual copy-paste.

Learn about n8n

Overview

The integration has two parts: create topics from n8n when something happens in your stack, and receive webhook callbacks when each interview session completes.

Creating topics

Use an HTTP Request node to call Eliciteer when a form is submitted, a row is added, or any trigger fires.

Receiving results

Eliciteer POSTs summary and collected info to your n8n Webhook URL when a participant finishes.

Prerequisites

An n8n instance (cloud or self-hosted)
A running Eliciteer backend that n8n can reach

API base URL: https://eliciteer.ai

Create a topic from n8n

When you want to start an interview automatically — for example after a new spreadsheet row or form submission — add an HTTP Request node in n8n.

Node configuration

Method: POST
URL: https://eliciteer.ai/api/topic
Authentication: None (MVP — API keys coming soon)
Body Content Type: JSON

Request body

{
  "text": "Find out the user's feedback on the new mobile app update.",
  "client_name": "Product Team",
  "client_email": "product@example.com",
  "webhook_url": "https://your-n8n-instance.com/webhook/your-webhook-id"
}

text — Briefing for the AI interviewer (what to find out).
webhook_url — Your n8n Webhook node URL (Step 2). Called when each interview session completes.
client_name / client_email — Optional metadata included in webhook payloads.

Response

Eliciteer returns the topic ID and a shareable interview link. Use the link in later nodes (e.g. send email). Each person who opens the link gets their own interview session.

Response

{
  "topic_id": "a3c93067-7a6b-4ef5-b77a-f33c23ecc9fc",
  "link": "https://eliciteer.ai/interview/a3c93067-7a6b-4ef5-b77a-f33c23ecc9fc"
}

Receive interview results

Add a Webhook node in n8n and copy its production URL into the webhook_url field when creating a topic.

Webhook node configuration

HTTP Method: POST
Path: /webhook/your-unique-path
Authentication: None (or Header Auth if you add it)

Payload on completion

When a participant finishes an interview, Eliciteer sends a POST to your webhook with:

Webhook payload

{
  "interview_id": "b4d04178-8c7c-5fg6-c88b-g44d34fdd0gd",
  "topic_id": "a3c93067-7a6b-4ef5-b77a-f33c23ecc9fc",
  "client_email": "product@example.com",
  "client_name": "Product Team",
  "interview_summary": "User prefers the new dark mode but found the navigation confusing.",
  "collected_info": "- User likes dark mode\n- User struggled with finding settings\n- Suggests larger icons",
  "completed_at": "2024-01-15T10:30:00Z"
}

One webhook per completed session. If multiple people complete interviews for the same topic, you receive multiple POST requests — one per interview.

Example workflow

1
Webhook node
Receives the completion payload from Eliciteer.
2
Google Sheets node
Appends interview_summary and collected_info to a spreadsheet.

Build it with n8n AI

In n8n, open a new workflow and use the AI Workflow Builder. Paste the prompt below — it describes the same Webhook → Google Sheets flow so n8n can generate the workflow for you.

n8n AI Workflow Builder prompt

Create an n8n workflow named "Eliciteer — Interview completed" that integrates with Eliciteer (https://eliciteer.ai), an AI-powered interview platform.

## Goal
When a participant finishes an Eliciteer interview, append the results to a Google Sheet.

## Trigger — Webhook node
- Add a Webhook node with HTTP method POST.
- Use a unique path, e.g. /webhook/eliciteer-interview-complete.
- This node receives POST requests from Eliciteer when each interview session completes (one webhook per completed interview).
- Expected JSON body fields:
  - interview_id (string)
  - topic_id (string)
  - client_email (string)
  - client_name (string)
  - interview_summary (string)
  - collected_info (string, may contain newlines)
  - completed_at (ISO 8601 timestamp)

## Step 2 — Google Sheets node
- Connect from the Webhook node output.
- Operation: Append row to a spreadsheet.
- Map columns using n8n expressions:
  - interview_id → {{ $json.interview_id }}
  - topic_id → {{ $json.topic_id }}
  - client_email → {{ $json.client_email }}
  - client_name → {{ $json.client_name }}
  - interview_summary → {{ $json.interview_summary }}
  - collected_info → {{ $json.collected_info }}
  - completed_at → {{ $json.completed_at }}
- Leave Google Sheets credentials as placeholders for me to configure.

## Notes
- Do not hard-code API keys; use credential placeholders.
- After building, remind me to copy the Webhook node's production URL into Eliciteer when creating a topic (POST https://eliciteer.ai/api/topic, field webhook_url).

Troubleshooting

Webhook not triggering

Check that the webhook_url in your create-topic request is correct and publicly reachable from the Eliciteer backend.

Local development

If Eliciteer runs locally and n8n is in the cloud, expose your backend with a tunnel (e.g. ngrok). If n8n is local, Eliciteer must be able to reach your webhook URL — use a tunnel for the n8n webhook as well.

Ready to try it?

Create your first topic in the app, or call the API directly from n8n using the steps above.

Create a topic Full API reference