Refiner

10 tools available

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

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.

Common workflows with Refiner

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Refiner actions 10

Every Refiner action below is a callable tool any Definable persona can invoke.

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.

Frequently asked questions

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.

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.

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.

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.

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.

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.

Ready to automate with Refiner?

Wire it up in minutes. No coding required.

← All integrations