How to Connect Uplup to n8n

n8n is an open-source workflow automation platform that lets you connect Uplup to 400+ other apps and services. When someone submits a quiz or form, n8n can instantly send that data to Google Sheets, Slack, your CRM, email tools, and more.

---

Installing the Uplup Node

The Uplup integration is available as a community node in n8n.

n8n Cloud

1. Open your n8n instance and go to Settings > Community Nodes
2. Click “Install a community node”
3. Enter n8n-nodes-uplup and click Install
4. The Uplup Trigger and Uplup nodes will appear in your node palette

Self-Hosted n8n

1. Go to Settings > Community Nodes in your n8n dashboard
2. Enter n8n-nodes-uplup and click Install
3. Alternatively, install via npm: npm install n8n-nodes-uplup

---

Connecting Your Uplup Account

Uplup supports two authentication methods in n8n:

Option 1: OAuth 2.0 (Recommended for n8n Cloud)

1. Add an Uplup node to your workflow
2. Click “Create New Credential” and select Uplup OAuth2 API
3. Enter your Client ID and Client Secret (provided by Uplup)
4. Click “Connect” — a popup will open to authorize your Uplup account
5. Select a workspace if you have multiple, then click Authorize

Option 2: API Key (Recommended for Self-Hosted)

1. In Uplup, go to Settings > API Keys
2. Create a new API key and copy it
3. In n8n, add an Uplup node and select Uplup API as the credential
4. Paste your API key into the API Key field

---

Setting Up the New Response Trigger

The Uplup Trigger node fires instantly when someone submits a quiz or form response.

1. Add the “Uplup Trigger” node to your workflow
2. Select an event type:
   • New Response (Quiz or Form) — triggers on all submissions
   • Quiz Completed — triggers only on quiz completions
   • Form Submitted — triggers only on form submissions
3. Optionally select a specific quiz or form, or leave blank to trigger on all
4. Activate your workflow — n8n will register a webhook with Uplup

---

Available Data Fields

When a response is submitted, the trigger provides these fields:

Core Fields

• submission_id — Unique submission identifier
• form_id — Quiz/Form ID
• form_title — Quiz/Form title
• content_type — “quiz” or “form”
• event_type — “quiz.completed” or “submission.created”

Contact Information

• email — Respondent’s email address
• name — Respondent’s name
• phone — Respondent’s phone number
• country_code — Country code
• region — Region or state
• submitted_at — Submission timestamp (ISO 8601)

Quiz-Specific Fields

• score — Quiz score
• score_percentage — Score as percentage
• result_outcome — Personality result or outcome
• pass_fail — Pass/fail status

Dynamic Answer Fields

Each question in your quiz or form generates a dynamic field with the prefix answer_. For example, a question labeled “What is your favorite color?” becomes answer_what_is_your_favorite_color.

---

Available Actions

The Uplup action node provides these operations:

• Get Quizzes/Forms — List all quizzes and forms in your workspace, with optional type filter
• Get a Quiz/Form — Retrieve details for a specific quiz or form
• Get Submissions — Retrieve all submissions for a specific quiz or form

---

Example Workflows

• Quiz results to Google Sheets — Uplup Trigger > Google Sheets (append row)
• New lead to Slack notification — Uplup Trigger > Slack (send message)
• Form submission to CRM — Uplup Trigger > HubSpot (create contact)
• Quiz completion email — Uplup Trigger > Gmail (send email)
• Submission backup — Uplup Trigger > Airtable (create record)

---

Troubleshooting

• “Pro Plan Required” error — The n8n integration requires a Pro plan or higher. Upgrade at uplup.com/pricing.
• OAuth connection fails — Make sure you’re logged into your Uplup account before authorizing. Try clearing cookies and reconnecting.
• Trigger not firing — Verify your workflow is activated (not just saved). Check that the webhook is registered in your Uplup dashboard under Settings > Webhooks.
• Missing data fields — Quiz-specific fields (score, result, pass/fail) are only populated for quiz submissions, not form submissions.
• API key not working — Ensure you’re using a live API key (starts with uplup_live_), not a test key.

---

Related

• How to Connect Uplup to Zapier
• Webhooks — Real-time Event Notifications