The Refiner modules allow you to monitor the completed surveys, segments, identify users, list contacts,  create, update, send, retrieve, and list the conversations, people, visitors, and websites in your Refiner account.

Getting Started with Refiner


The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Refiner to Integromat

To connect your Refiner account to Integromat you need to obtain the API Key from your Refiner account and insert it in the Create a connection dialog in the Integromat module.

1. Log in to your Refiner account.

2. Click Integrations () > Get API Key. Copy the API key to your clipboard.

3. Go to Integromat and open the Refiner module's Create a connection dialog.

4. In the Connection name field, enter a name for the connection.

5. In the API Key field, enter the API key copied in step 2, and click Continue.

The connection has been established.


See the Setting Up Refiner Webhooks to add webhooks to your Refiner account.

Watch Completed Survey

Triggers when a survey is completed.

Webhook NameEnter a name for the webhook.

Watch User Entered Segment

Triggers when a user has entered the segment.

Webhook NameEnter a name for the webhook.


Identify a User

Creates a new user in Refiner or updates an already existing user.

ConnectionEstablish a connection to your Refiner account.
User IDSelect or map the User ID you want to identify.
When you identify a user for the first time, a newcontact will be created in Refiner. All subsequent calls with the same user ID will update their attributes.
Additional DataEnter (map) the additional fields and the values of the user you want to identify. For example, the user's first name.

Track an Event 

Tracks events performed by users.

ConnectionEstablish a connection to your Refiner account.
User IDSelect or map the User ID whose event you want to track.
Event NameEnter (map) the event name you want to track.

Make an API Call

Performs an arbitrary authorized API call.

ConnectionEstablish a connection to your Refiner account.

Enter a path relative to For example: /v1/contacts 

For the list of available endpoints, refer to the Refiner API Documentation.


Select the HTTP method you want to use:

to retrieve information for an entry.

to create a new entry.

to update/replace an existing entry.

to make a partial entry update.

to delete an entry.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter the body content for your API call.

Example of Use - List Responses

The following API call returns all the responses from your Refiner account:



Matches of the search can be found in the module's Output under Bundle > Body > items
In our example, 8 responses were returned:


List Contacts

Lists all contacts.

ConnectionEstablish a connection to your Refiner account.
Order bySelect or map the order in which you want to list the contacts. For example, Display Name.
From UUIDSelect or map the UUI ID to list the contacts associated with a specified survey.
Segment UUIDSelect or map the Segment ID to list the responses of the contacts that match the specified segment.
LimitSet the maximum number of users Integromat should return during one execution cycle.

Setting Up Refiner Webhooks

1. In the Integromat account, open any Watch module, enter a name for the webhook, click Save, and copy the URL address to your clipboard. 

2. Click OK and save the trigger.

3. Log in to your Refiner account. Click Integrations () > Webhook.

4. Enter the details as follows and click Save Webhook:

Webhook NameEnter (map) a name for the webhook.
Trigger EventSelect the events for which you want to receive the triggers.
Destination URLEnter (map) the URL address copied in step 1.
Secret Auth-TokenThe Refiner can add a secret Auth-Token to secure your webhooks if you like. Your token will be added as a Bearer Token in the HTTP Auth Header.

You have successfully added the webhook.

Popular use cases from our blog


How to Automate Data Collection - Part 5: CRM Systems


How to Automate Data Collection - Part 4: Chatbot Marketing


How to Automate Data Collection - Part 3: Paid Ads


How to Automate Data Collection - Part 2: Email Marketing Segmentation


5 Automated Solutions to Personalize Customer Experience


How to Automate Data Collection - Part 1: Online Forms

Didn’t find what you were looking for?


Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.