Refiner

Learn how to use Refiner with Composio

Overview

SLUG

REFINER

Description

Refiner is a customer feedback and survey tool designed to help businesses collect and analyze user insights.

Authentication Details

generic_api_key
stringRequired

Tools

SLUG: REFINER_DELETE_CONTACT

Tool to delete a specific contact by its identifier. use after confirming the contact's id, email, or uuid.

Action Parameters

email
string
id
string
uuid
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_ACCOUNT_INFO

Tool to fetch refiner account subscription and environment usage details. use when you need to audit your current plan and usage.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_CONTACT

Tool to retrieve details of a specific contact by its id. use when you need all stored traits for a known user.

Action Parameters

email
string
id
string
uuid
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_CONTACTS

Tool to retrieve a list of contacts from your refiner account. use when you need to filter or paginate through contacts.

Action Parameters

form_uuid
string
order_by
stringDefaults to first_seen_at
page
integerDefaults to 1
page_cursor
string
page_length
integerDefaults to 50
segment_uuid
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_FORMS

Tool to retrieve a list of forms (surveys) from your refiner account with optional filtering and pagination. use when you need to list surveys by state, page, or include extra info/config.

Action Parameters

include_config
boolean
include_info
boolean
list
stringDefaults to all
page
integerDefaults to 1
page_length
integerDefaults to 50

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_REPORTING

Tool to retrieve aggregated reporting data for surveys including metrics and analytics. use when you need survey analytics over a time range filtered by type, question identifiers, tags, forms, or segments.

Action Parameters

date_range_end
date_range_start
form_uuids
array
question_identifiers
array
segment_uuids
array
tag_uuids
array
type
stringRequired

Action Response

average
number
count
integer
csat
integer
data
object
datapoints
integer
date_range_end
Required
date_range_start
Required
error
string
nps
integer
responses
integer
successful
booleanRequired
sum
integer
views
integer

SLUG: REFINER_GET_RESPONSES

Tool to retrieve all survey responses from your refiner account with optional filtering and pagination. use after confirming survey creation to pull response data.

Action Parameters

date_range_end
date_range_start
form_uuid
string
form_uuids
array
include
stringDefaults to completed
page
integerDefaults to 1
page_cursor
string
page_length
integerDefaults to 50
search
string
segment_uuid
string
segment_uuids
array
with_attributes
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_GET_SEGMENTS

Tool to retrieve a list of user segments from your refiner account. use when you need to view or paginate segments.

Action Parameters

page
integerDefaults to 1
page_cursor
string
page_length
integerDefaults to 50

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_TRACK_EVENT

Tool to record a user event by name for a user identified via user id or email. use after confirming the identifier and event name.

Action Parameters

email
string
event
stringRequired
id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REFINER_UPDATE_CONTACT

Tool to update an existing contact's attributes or account. use when you have a contact `id` or `email` and want to modify traits or grouping.

Action Parameters

account
object
attributes
object
email
string
id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired