# Refiner

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

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `REFINER`
- **Version:** 20260429_00

## Tools

### Delete Contact

**Slug:** `REFINER_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

**Slug:** `REFINER_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

**Slug:** `REFINER_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

**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.

### Get Forms

**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.

### Get Reporting

**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.

### Get Survey Responses

**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.

### Get Segments

**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.

### Track Event

**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.

### Update Contact

**Slug:** `REFINER_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.
