Skip to docs navigation

Refiner integration guide

Verified

How to connect Refiner to WEXTL and use its 2 triggers and 19 actions in your workflows. About Refiner: In-app survey software: send users and events, store and read survey responses, manage surveys and segments, and react to new responses.

  • 2 triggers
  • 8 searches
  • 11 actions
  • Instant (webhooks)
  • Auth: API key

AI-assisted documentation8 min read

This documentation is compiled from our integration source code, internal specs for Refiner, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Refiner on WEXTL →
  • Refiner
  • WEXTL
  • CertSeal
  • Bloomreach
  • Cardly
  • Beamer
  • Captions
  • Birdeye
  • Basin
  • Auphonic
  • Ablefy
  • ActiveTrail
  • ActiveCampaign
  • Action Network
  • Bitly
  • Bouncer
  • Clipdrop
  • Bumpups
  • Brandfetch
  • APITemplate.io
  • Bannerbear
  • Claid AI
  • Buk Capacitaciones
  • Castmagic
  • Ahrefs
  • Clearout
  • Campaign Monitor
  • Bettermode
  • Brandwatch
  • beehiiv
  • AWeber
  • Akeneo
  • API KeypasswordRequired

    In Refiner open Environment Settings, then API Keys, and copy the key. Each environment (Production, Testing) has its own key.[1]

  1. Log in to your WEXTL account, add the Refiner node module to your workflow, and click Create new credential.Instant triggers use webhooks. Click Create a webhook first when adding one, then create the credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Refiner account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Watch Events (Instant)

TriggerInstant trigger for Refiner events.
Output fields[3]
FieldType
Uuidtext
Project Uuidtext
Remote IDtext
Emailtext
First Seen Atdate
Last Seen Atdate
Attributesobject
Plantext
Form Submissions Counttext
Segmentsarray
Accountobject
Uuidtext
Remote IDtext
Domaintext
First Seen Atdate
Last Seen Atdate
Attributesobject
Triggered Eventtext
Formobject
Uuidtext
Nametext
Responseobject
Uuidtext
First Shown Atdate
Last Shown Atdate
Show Countertext
First Data Reception Attext
Last Data Reception Attext
Completed Attext
Dismissed Attext
Received Attext
Dataobject

Watch New Responses

TriggerPolls responses and emits each response.
Output fields[3]
FieldType
Uuidtext
First Shown Attext
Last Shown Attext
Show Counternumber
First Data Reception Attext
Last Data Reception Attext
Completed Attext
Received Attext
Dismissed Attext
Formobject
Uuidtext
Nametext
Dataobject
First Questiontext
Second Questiontext
Contactobject
Uuidtext
Remote IDtext
Emailtext
Display Nametext
Accountobject

Get a Contact

SearchProfile of one identified person.
Input fields[3]
FieldType
User IDtext
Emailtext
Refiner UUIDtext
Output fields[3]
FieldType
Uuidtext
Remote IDtext
Emailtext
Display Nametext
First Seen Atdate
Last Seen Atdate
Attributesobject
Plantext
Segmentsarray
Accountobject
Uuidtext
Remote IDtext
Display Nametext
Domaintext

Get a Report

SearchAggregated score statistics over survey data.
Input fields[3]
FieldType
TypeRequired
choice
Question Identifiersarray
Surveyschoice
Segmentschoice
Tagsarray
Startdate
Enddate
Response Dataarray
Filterobject
Contact Dataarray
Filterobject
Account Dataarray
Filterobject
Output fields[3]
FieldType
Npsnumber
Responsesnumber
Distributionobject
Promotersnumber
Passivesnumber
Detractorsnumber

Get the Account Info

SearchPlan and environment details for the account.
Output fields[3]
FieldType
Subscriptionobject
Plantext
Mtu Countnumber
Mtu Limitnumber
Mte Countnumber
Mpv Countnumber
Mpv Limitnumber
Msr Countnumber
Msr Limitnumber
Environmentsarray

List Contacts

SearchContacts across the project, narrowed on request.
Input fields[3]
FieldType
Order Bychoice
Surveychoice
Segmentchoice
Searchtext
Limitnumber
Output fields[3]
FieldType
Uuidtext
Remote IDtext
Emailtext
Display Nametext
First Seen Atdate
Last Seen Atdate
Attributesobject
Plantext
Segmentsarray
Accountobject
Uuidtext
Remote IDtext
Display Nametext
Domaintext

List Form History

SearchEdit trail of a single survey.
Input fields[3]
FieldType
SurveyRequired
choice
Limitnumber
Output fields[3]
FieldType
Uuidtext
Actiontext
Snapshotobject
Nametext
Channelsarray
Updated Atdate
Created Atdate

List Forms

SearchSurveys in the project.
Input fields[3]
FieldType
Listchoice
Include Configboolean
Include Infoboolean
Limitnumber
Output fields[3]
FieldType
Uuidtext
Nametext
Channelsarray

List Responses

SearchStored survey answers, filterable.
Input fields[3]
FieldType
Surveyschoice
Segmentschoice
Tagsarray
Startdate
Enddate
Includechoice
Searchtext
Response Dataarray
Filterobject
Contact Dataarray
Filterobject
Account Dataarray
Filterobject
With Attributesboolean
Limitnumber
Output fields[3]
FieldType
Uuidtext
First Shown Attext
Last Shown Attext
Show Counternumber
First Data Reception Attext
Last Data Reception Attext
Completed Attext
Received Attext
Dismissed Attext
Formobject
Uuidtext
Nametext
Dataobject
First Questiontext
Second Questiontext
Contactobject
Uuidtext
Remote IDtext
Emailtext
Display Nametext
Accountobject

List Segments

SearchSegments defined in the project.
Input fields[3]
FieldType
Limitnumber
Output fields[3]
FieldType
Uuidtext
Nametext
Is Manualboolean

Add a Contact to a Segment

ActionManual segment membership for one contact.
Input fields[3]
FieldType
SegmentRequired
choice
User IDtext
Emailtext
Output fields[3]
FieldType
Messagetext
Contact UUIDtext
Segment UUIDtext

Add Tags to a Response

ActionLabels a stored survey response with tags.
Input fields[3]
FieldType
Response UUIDRequired
text
TagsRequired
array
Output fields[3]
FieldType
Messagetext

Archive a Form

ActionArchives one survey in Refiner.
Input fields[3]
FieldType
SurveyRequired
choice
Output fields[3]
FieldType
Messagetext

Create a Form Copy

ActionClones a survey under a new name.
Input fields[3]
FieldType
SurveyRequired
choice
New NameRequired
text
Output fields[3]
FieldType
Messagetext
Source Form UUIDtext
New Form UUIDtext

Create a Response

ActionAdds an externally collected answer to a survey.
Input fields[3]
FieldType
SurveyRequired
choice
User IDtext
Emailtext
Refiner UUIDtext
Answersarray
Answerobject
Datedate
Tagsarray
Account IDtext
Account Nametext
Account Traitsarray
Traitobject
Prevent Duplicatesboolean
Output fields[3]
FieldType
Messagetext
UUIDtext

Delete a Contact

ActionDeletes one person from the project.
Input fields[3]
FieldType
User IDtext
Emailtext
Refiner UUIDtext
Output fields[3]
FieldType
Messagetext

Identify a User

ActionSends person traits into Refiner.
Input fields[3]
FieldType
User IDtext
Emailtext
Traitsarray
Traitobject
Account IDtext
Account Nametext
Account Traitsarray
Traitobject
Output fields[3]
FieldType
Messagetext
Contact UUIDtext

Make an API Call

universalCustom Refiner REST API request.
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber

Remove a Contact from a Segment

ActionEnds manual segment membership.
Input fields[3]
FieldType
SegmentRequired
choice
User IDtext
Emailtext
Output fields[3]
FieldType
Messagetext
Contact UUIDtext
Segment UUIDtext

Track an Event

ActionRecords a behaviour event for a person.
Input fields[3]
FieldType
EventRequired
text
User IDtext
Emailtext
Output fields[3]
FieldType
Messagetext

Update a Form Publication

ActionPublishes or unpublishes a survey.
Input fields[3]
FieldType
SurveyRequired
choice
Publishedboolean
Output fields[3]
FieldType
Messagetext

Look for Refiner templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Refiner Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Refiner.
  4. WEXTL® visual workflow builder data.

Last updated: Nov 14, 2026 14:55

How we write our apps documentation

How we compile these docs: sources, the role of AI, and how we verify.