Refiner

forms & surveys 10 tools available

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

About this integration

Connect Refiner to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Refiner's 10 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Connect Refiner to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 10 exposed

Plans All, incl. Free

Data Never trained on

Refiner · in workflows

What teams actually run.

Three patterns teams run with Refiner on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Trigger on event

│ Listen for a new event

│ Parse and validate the payload

└ Take an action with the linked tool

Daily summary

│ Pull yesterday's activity

│ Summarise with the model of your choice

└ Send the digest via email or Slack

Cross-tool sync

│ Read records from one app

│ Transform with a persona

└ Write the result back via this integration

10 tools available

The Refiner toolbox.

Every Refiner capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

Delete Contact

Tool to delete a specific contact by its identifier. Provide either the user ID or email address to identify and delete the contact.

Get Account Info

Retrieves Refiner account information including subscription plan, usage limits, and environment statistics. This action provides: - Current subscription plan and usage limits (MTU, MTE, MPV, MSR) - Usage counters for monthly tracked users, events, page views, and survey responses - Per-environment breakdown of usage statistics - Last updated timestamps for all usage metrics Use this when you need to check account status, monitor usage against limits, or audit environment statistics.

Get Contact

Retrieve detailed information about a specific contact using their ID, email, or UUID. Returns all stored attributes, segments, and account information.

Get Contacts

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

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.

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.

Get Survey 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.

Get Segments

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

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.

Update Contact

Tool to create or update a contact's attributes or account. Identifies a contact by `id` or `email` and updates their traits or account grouping. If the contact doesn't exist, it will be created automatically.

See it run

One prompt, start to finish.

A real prompt, the Refiner tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Refiner task end-to-end — plan it, execute across the API, and hand back a verified result.

refiner.delete_contact Tool to delete a specific contact by its identifier. Provide either the user ID or email a

refiner.get_account_info Retrieves Refiner account information including subscription plan, usage limits, and envir

refiner.get_contact Retrieve detailed information about a specific contact using their ID, email, or UUID. Ret · verified

done

Done. Refiner responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Refiner

Questions, answered.

What teams ask before connecting Refiner.

01 What can I automate with Refiner on Definable?

Anything Refiner exposes through its API. Common forms & surveys workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 10 Refiner tools directly, then chain the result into another integration without you writing code.

02 How does Refiner authentication work?

Refiner uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

03 Is the Refiner integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 10 Refiner tools. You only need a separate Refiner subscription if Refiner itself charges per seat or per API call.

04 Is using Refiner through Definable secure?

Every call from a persona to Refiner is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

05 How do I get started with Refiner on Definable?

Sign up for Definable, open the integrations page, find Refiner, and connect via OAuth or API key. You can immediately attach Refiner to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

06 What Refiner actions does Definable expose?

Definable exposes all 10 Refiner actions as callable tools — including `Delete Contact`, `Get Account Info`, `Get Contact`, plus 7 more. Each tool gets a typed parameter schema so personas know exactly how to call it.