Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
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.
Every Refiner action below is a callable tool any Definable persona can invoke.
Tool to delete a specific contact by its identifier. Provide either the user ID or email address to identify and delete the contact.
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.
Retrieve detailed information about a specific contact using their ID, email, or UUID. Returns all stored attributes, segments, and account information.
Tool to retrieve a list of contacts from your Refiner account. Use when you need to filter or paginate through contacts.
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.
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.
Tool to retrieve all survey responses from your Refiner account with optional filtering and pagination. Use after confirming survey creation to pull response data.
Tool to retrieve a list of user segments from your Refiner account. Use when you need to view or paginate segments.
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.
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.
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.
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.
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.
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.
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.
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.
Wire it up in minutes. No coding required.