# Refiner AI integration on Definable

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

## What this connects

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

Vendor: https://refiner.io/

## Tools available

**10** tools available. First 10:

- `REFINER_DELETE_CONTACT` — 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.
- `REFINER_GET_ACCOUNT_INFO` — 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.
- `REFINER_GET_CONTACT` — Get Contact — Retrieve detailed information about a specific contact using their ID, email, or UUID. Returns all stored attributes, segments, and account information.
- `REFINER_GET_CONTACTS` — Get Contacts — Tool to retrieve a list of contacts from your Refiner account. Use when you need to filter or paginate through contacts.
- `REFINER_GET_FORMS` — 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.
- `REFINER_GET_REPORTING` — 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.
- `REFINER_GET_RESPONSES` — 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.
- `REFINER_GET_SEGMENTS` — Get Segments — Tool to retrieve a list of user segments from your Refiner account. Use when you need to view or paginate segments.
- `REFINER_TRACK_EVENT` — 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.
- `REFINER_UPDATE_CONTACT` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use Refiner

Inside a Definable workflow, Refiner is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Refiner** — the Researcher (GPT-5.5) pulls context from Refiner (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Refiner** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Refiner (create record, post message, draft email).
- **Designer / Engineer → Distributor → Refiner** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Refiner (attach file, open PR comment, post status).

The Verifier checks every Refiner call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- forms & surveys — https://definable.ai/apps/category/forms-&-surveys/
- analytics — https://definable.ai/apps/category/analytics/

## Related

- HTML page: https://definable.ai/apps/refiner/
- Same category (forms & surveys): https://definable.ai/apps/category/forms-&-surveys/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt