{"id":28874,"date":"2026-08-25T19:30:20","date_gmt":"2026-08-25T19:30:20","guid":{"rendered":"https:\/\/refiner.io\/docs\/?post_type=knowledgebase&#038;p=28874"},"modified":"2026-08-25T19:34:00","modified_gmt":"2026-08-25T19:34:00","slug":"n8n-integration","status":"publish","type":"knowledgebase","link":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/","title":{"rendered":"n8n Integration"},"content":{"rendered":"\n\n\n<h2 class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p><a href=\"https:\/\/n8n.io\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n<\/a> is a workflow automation platform that lets you connect different apps and services and automate processes between them.<\/p>\n\n\n\n<p>You can connect Refiner and n8n in both directions:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Refiner \u2192 n8n:<\/strong> Send survey responses and other Refiner data to an n8n workflow in real time.<\/li>\n\n\n\n<li><strong>n8n \u2192 Refiner:<\/strong> Update user data in Refiner from any n8n workflow.<\/li>\n<\/ul>\n\n\n\n<p>The integration uses Refiner&#8217;s <strong>Webhooks<\/strong> and <strong>REST API<\/strong>, together with n8n&#8217;s built-in <strong>Webhook<\/strong> and <strong>HTTP Request<\/strong> nodes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Prerequisites<\/h2>\n\n\n\n<p>To set up the integration, you&#8217;ll need a Refiner account and an n8n account.<\/p>\n\n\n\n<p>If you want to send user data from n8n to Refiner, you&#8217;ll also need your Refiner API key. You can find it in your Refiner dashboard under <strong>Integrations &gt; n8n<\/strong>.<\/p>\n\n\n\n<p>When updating existing users in Refiner, we recommend using the same unique User ID that you use when identifying users with our JavaScript or Mobile SDKs.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Send survey data to n8n<\/h2>\n\n\n\n<p>A popular use case is to trigger an n8n workflow whenever a new survey response is collected in Refiner.<\/p>\n\n\n\n<p>For example, you could use n8n to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Add survey responses to a database or spreadsheet<\/li>\n\n\n\n<li>Update customer records in your CRM<\/li>\n\n\n\n<li>Send personalized emails based on survey responses<\/li>\n\n\n\n<li>Notify your team about specific responses<\/li>\n\n\n\n<li>Trigger any other workflow supported by n8n<\/li>\n<\/ul>\n\n\n\n<p>Sending data from Refiner to n8n is done using our <strong>Webhooks<\/strong> integration.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Create a Webhook in n8n<\/h3>\n\n\n\n<p>Start by creating a new workflow in n8n and add a <strong>Webhook<\/strong> node as the first step.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Add a <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.webhook\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>Webhook node<\/strong><\/a> to your workflow.<\/li>\n\n\n\n<li>Set the <strong>HTTP Method<\/strong> to <code>POST<\/code>.<\/li>\n\n\n\n<li>Select the <strong>Test URL<\/strong> and copy the URL provided by n8n.<\/li>\n\n\n\n<li>Click <strong>Listen for test event<\/strong> so that n8n is ready to receive your first webhook.<\/li>\n<\/ol>\n\n\n\n<p>You can find more details about configuring Webhooks in the n8n Webhook node documentation.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Create a Webhook in Refiner<\/h3>\n\n\n\n<p>Next, head over to your Refiner account:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to <strong>Integrations &gt; Webhooks<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Create Webhook<\/strong>.<\/li>\n\n\n\n<li>Give your webhook a name, for example <code>n8n<\/code>.<\/li>\n\n\n\n<li>Paste the Test URL provided by n8n into the <strong>Destination URL<\/strong> field.<\/li>\n\n\n\n<li>Choose the trigger event you want to use.<\/li>\n\n\n\n<li>Save your webhook.<\/li>\n<\/ol>\n\n\n\n<p>You can use the <strong>Send test<\/strong> option in Refiner to send sample data to n8n.<\/p>\n\n\n\n<p>Once n8n receives the webhook, you&#8217;ll see the Refiner payload in your Webhook node and can use its data in the following steps of your workflow.<\/p>\n\n\n\n<p>Refiner webhooks can include survey response data, information about the survey, user identifiers, user traits, account information, tags, and other metadata.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Activate your workflow<\/h3>\n\n\n\n<p>n8n provides separate Webhook URLs for testing and production.<\/p>\n\n\n\n<p>Once your workflow is ready:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Copy the <strong>Production URL<\/strong> from your n8n Webhook node.<\/li>\n\n\n\n<li>Replace the Test URL in your Refiner Webhook configuration with the Production URL.<\/li>\n\n\n\n<li>Activate your n8n workflow.<\/li>\n<\/ol>\n\n\n\n<p>From this moment on, Refiner will automatically trigger your n8n workflow whenever the configured event occurs.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Update user data in Refiner<\/h2>\n\n\n\n<p>You can also send data in the opposite direction and update user profiles in Refiner from an n8n workflow.<\/p>\n\n\n\n<p>This allows you to import user traits from any system connected to n8n and use this data in Refiner to create user segments, target surveys, or analyze survey responses.<\/p>\n\n\n\n<p>To update a user, use an n8n <strong>HTTP Request<\/strong> node to call Refiner&#8217;s <strong><a href=\"https:\/\/refiner.io\/docs\/api\/#identify-user\" target=\"_blank\" rel=\"noreferrer noopener\">Identify User API<\/a><\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Configure the HTTP Request node<\/h3>\n\n\n\n<p>Add an <strong><a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.httprequest\" target=\"_blank\" rel=\"noreferrer noopener\">HTTP Request<\/a><\/strong> node to your n8n workflow and configure it with the following settings:<\/p>\n\n\n\n<p><strong>Method<\/strong>: <code>POST<\/code><\/p>\n\n\n\n<p><strong>URL<\/strong>: <code>https:\/\/api.refiner.io\/v1\/identify-user<\/code><\/p>\n\n\n\n<p><strong>Authorization header<\/strong> <code>Authorization: Bearer YOUR_API_KEY<\/code><\/p>\n\n\n\n<p>Replace <code>YOUR_API_KEY<\/code> with the API key from <strong>Integrations &gt; REST API<\/strong> in your Refiner account.<\/p>\n\n\n\n<p>Set the request body to JSON and provide the user identifier together with any user traits you want to update.<\/p>\n\n\n\n<p>For example:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"id\": \"YOUR_USER_ID\",\n  \"plan\": \"pro\",\n  \"company_size\": 25,\n  \"customer_since_at\": \"2025-01-15\"\n}\n<\/pre>\n\n\n\n<p>Instead of using static values, you can map values from previous nodes in your n8n workflow into the request body.<\/p>\n\n\n\n<p>You can find more information about configuring API requests in the n8n HTTP Request node documentation.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Identifying users<\/h3>\n\n\n\n<p>Each request needs to include either an <code>id<\/code> or an <code>email<\/code> to identify the user.<\/p>\n\n\n\n<p>Whenever possible, we recommend using the same unique User ID that you use when identifying the user with the Refiner JavaScript or Mobile SDK.<\/p>\n\n\n\n<p>If the user already exists in Refiner, the provided traits are added to or updated on their user profile. If the user doesn&#8217;t exist yet, Refiner automatically creates a new user profile.<\/p>\n\n\n\n<p>You are free to send additional user traits alongside the user identifier. New traits are created automatically in Refiner and can then be used for user segmentation and survey targeting.<\/p>\n\n\n\n<p>That&#8217;s it! With Webhooks and the Refiner API, you can use n8n to build custom two-way workflows between Refiner and virtually any system connected to your n8n account.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction n8n is a workflow automation platform that lets you connect different apps and services and automate processes between them. You can connect Refiner and n8n in both directions: The integration uses Refiner&#8217;s Webhooks and REST API, together with n8n&#8217;s built-in Webhook and HTTP Request nodes. Prerequisites To set up the integration, you&#8217;ll need a [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","template":"","knowledgebase_tag":[],"class_list":["post-28874","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-integrations"],"acf":[],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","1536x1536":"","2048x2048":"","ab-block-post-grid-landscape":"","ab-block-post-grid-square":"","gb-block-post-grid-landscape":"","gb-block-post-grid-square":""},"post_excerpt_stackable_v2":"<p>Introduction n8n is a workflow automation platform that lets you connect different apps and services and automate processes between them. You can connect Refiner and n8n in both directions: Refiner \u2192 n8n: Send survey responses and other Refiner data to an n8n workflow in real time. n8n \u2192 Refiner: Update user data in Refiner from any n8n workflow. The integration uses Refiner&#8217;s Webhooks and REST API, together with n8n&#8217;s built-in Webhook and HTTP Request nodes. Prerequisites To set up the integration, you&#8217;ll need a Refiner account and an n8n account. If you want to send user data from n8n to&hellip;<\/p>\n","category_list_v2":"","author_info_v2":{"name":"Moritz Dausinger","url":"https:\/\/refiner.io\/docs\/author\/user\/"},"comments_num_v2":"0 comments","yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>n8n Integration<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"n8n Integration\" \/>\n<meta property=\"og:description\" content=\"Introduction n8n is a workflow automation platform that lets you connect different apps and services and automate processes between them. You can connect Refiner and n8n in both directions: The integration uses Refiner&#8217;s Webhooks and REST API, together with n8n&#8217;s built-in Webhook and HTTP Request nodes. Prerequisites To set up the integration, you&#8217;ll need a [...]Read More...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\" \/>\n<meta property=\"og:site_name\" content=\"Refiner Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-25T19:34:00+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\",\"url\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\",\"name\":\"n8n Integration\",\"isPartOf\":{\"@id\":\"https:\/\/refiner.io\/docs\/#website\"},\"datePublished\":\"2026-08-25T19:30:20+00:00\",\"dateModified\":\"2026-08-25T19:34:00+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/refiner.io\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"n8n Integration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/refiner.io\/docs\/#website\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"name\":\"Refiner Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/refiner.io\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/refiner.io\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/refiner.io\/docs\/#organization\",\"name\":\"Refiner Documentation\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"width\":400,\"height\":61,\"caption\":\"Refiner Documentation\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"n8n Integration","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/","og_locale":"en_US","og_type":"article","og_title":"n8n Integration","og_description":"Introduction n8n is a workflow automation platform that lets you connect different apps and services and automate processes between them. You can connect Refiner and n8n in both directions: The integration uses Refiner&#8217;s Webhooks and REST API, together with n8n&#8217;s built-in Webhook and HTTP Request nodes. Prerequisites To set up the integration, you&#8217;ll need a [...]Read More...","og_url":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/","og_site_name":"Refiner Documentation","article_modified_time":"2026-08-25T19:34:00+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/","url":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/","name":"n8n Integration","isPartOf":{"@id":"https:\/\/refiner.io\/docs\/#website"},"datePublished":"2026-08-25T19:30:20+00:00","dateModified":"2026-08-25T19:34:00+00:00","breadcrumb":{"@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/refiner.io\/docs\/kb\/integrations\/n8n-integration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/refiner.io\/docs\/"},{"@type":"ListItem","position":2,"name":"n8n Integration"}]},{"@type":"WebSite","@id":"https:\/\/refiner.io\/docs\/#website","url":"https:\/\/refiner.io\/docs\/","name":"Refiner Documentation","description":"","publisher":{"@id":"https:\/\/refiner.io\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/refiner.io\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/refiner.io\/docs\/#organization","name":"Refiner Documentation","url":"https:\/\/refiner.io\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","width":400,"height":61,"caption":"Refiner Documentation"},"image":{"@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28874","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/comments?post=28874"}],"version-history":[{"count":3,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28874\/revisions"}],"predecessor-version":[{"id":28877,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28874\/revisions\/28877"}],"wp:attachment":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/media?parent=28874"}],"wp:term":[{"taxonomy":"knowledgebase_tag","embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase_tag?post=28874"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}