# Mopinion

Mopinion captures user feedback across websites and apps, providing insights, analytics, and reporting to optimize user experiences and drive conversions

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `MOPINION`
- **Version:** 20260312_00

## Tools

### Get Account

**Slug:** `MOPINION_GET_ACCOUNT`

Tool to retrieve the current authenticated account information. Use to verify authentication and get account details.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset by ID

**Slug:** `MOPINION_GET_DATASET_BY_ID`

Retrieve complete metadata for a specific Mopinion dataset (feedback form) by its ID. Returns dataset properties including name, associated report ID, data source type, and description. Use this action when you need detailed information about a specific dataset/form. To discover available dataset IDs, use the List Datasets action first. This is a read-only operation that does not modify any data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dataset_id` | string | Yes | The unique identifier of the dataset (form) to retrieve. Can be provided as an integer or string. Use the List Datasets action to discover available dataset IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Feedback

**Slug:** `MOPINION_GET_DATASET_FEEDBACK`

Retrieve feedback items (survey responses) for a specific dataset/form with optional pagination and filtering. Use this action to fetch multiple feedback entries from a dataset. Each feedback item contains the survey responses including custom fields, scores, metadata, and timestamps. Supports pagination for large result sets and filtering by field values. For retrieving a single feedback item by ID, use GET_DATASET_FEEDBACK_BY_ID instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return |
| `limit` | integer | No | Maximum number of results per page (max 100) |
| `filters` | object | No | Field-level filters as a map of field_key to filter value. Serialized as filter[{field_key}]=value in the query string |
| `dataset_id` | integer | Yes | Identifier of the dataset (form) to retrieve feedback for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Feedback By ID

**Slug:** `MOPINION_GET_DATASET_FEEDBACK_BY_ID`

Retrieves a single feedback item by its unique identifier from a specific dataset. Use this tool when you need detailed information about a specific feedback item. First obtain the dataset_id using List Datasets, then get feedback_id values using Get Dataset Feedback. **Important Notes:** - Returns a warning in metadata if the feedback item doesn't exist (with null field values) - Returns 404 error if the dataset_id itself is invalid or inaccessible - The response includes feedback fields, tags, scores, timestamps, and associated metadata

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dataset_id` | integer | Yes | Numeric identifier of the dataset (form) containing the feedback. Obtain this from List Datasets action. |
| `feedback_id` | integer | Yes | Numeric identifier of the specific feedback item to retrieve. Obtain this from Get Dataset Feedback action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Field Definitions

**Slug:** `MOPINION_GET_DATASET_FIELDS`

Tool to retrieve field definitions for a dataset. Use when you need the schema of a dataset's fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dataset_id` | integer | Yes | Unique identifier of the dataset whose field definitions should be retrieved. Use the LIST_DATASETS action to discover available dataset IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deployment by ID

**Slug:** `MOPINION_GET_DEPLOYMENT_BY_ID`

Retrieves detailed configuration for a specific feedback form deployment by its ID. Returns deployment rules, trigger conditions, scheduling settings, target URLs, and active status. Use this to understand when, where, and how a feedback form is displayed to users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deployment_id` | string | Yes | The deployment key (identifier) to retrieve. This is the 'key' field from the deployments list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deployments

**Slug:** `MOPINION_GET_DEPLOYMENTS`

Tool to list all deployments for the authenticated Mopinion account. Use after setting up authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accept` | string | No | Optional Accept header override, e.g., application/json |
| `version` | string | No | Optional Mopinion API version header value, e.g., v1 or v2 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Report By ID

**Slug:** `MOPINION_GET_REPORT_BY_ID`

Retrieves detailed information about a specific Mopinion report by its ID. Returns comprehensive report details including name, description, language, creation date, and all associated datasets with their metadata. Use this when you need full information about a specific report. To find available report IDs, use the Get Reports action first. Example use case: Get complete details of report 22511 to understand its datasets and configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report_id` | integer | Yes | Unique numeric identifier of the Mopinion report to retrieve. Obtain this from the Get Reports action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Report Feedback

**Slug:** `MOPINION_GET_REPORT_FEEDBACK`

Tool to retrieve feedback items for a report. Use when you need paginated and filtered feedback entries for analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-based). |
| `limit` | integer | No | Maximum number of feedback items to return per page (1-100). |
| `filters` | object | No | Server-side filters serialized as filter[field]=value in query parameters. |
| `report_id` | integer | Yes | The unique identifier of the report to retrieve feedback for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Report Fields

**Slug:** `MOPINION_GET_REPORT_FIELDS`

Tool to retrieve field definitions for a specific report. Use when you need the schema of a report's feedback fields before constructing or analyzing forms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report_id` | integer | Yes | The unique ID of the report to retrieve fields for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Root

**Slug:** `MOPINION_GET_ROOT`

Check Mopinion API availability and get version information. Pings the API health check endpoint (/ping) and returns status code, 'pong' response, and current API version. Use this to verify the API is reachable and operational.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `extra_path` | string | No | Optional path to append to the base URL. Defaults to '/ping' for the standard health check endpoint. Use this to test other endpoints if needed. |
| `custom_base_url` | string | No | Optional override for the Mopinion API base URL. If not provided, the action uses the connection's base_url when it points to a Mopinion domain; otherwise it falls back to 'https://api.mopinion.com'. |
| `include_auth_header` | boolean | No | Whether to include the Authorization header in the request. Defaults to False because the root ping does not require authentication. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |