# Satismeter

SatisMeter is a customer feedback platform that enables businesses to collect and analyze user feedback through targeted surveys.

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

## Tools

### Embed Survey

**Slug:** `SATISMETER_EMBED_SURVEY`

Tool to generate a JavaScript snippet to embed a SatisMeter survey. Use after configuring your project and obtaining your write key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `traits` | object | No | Additional user profile information |
| `userId` | string | No | Unique identifier for the user to target with the survey |
| `settings` | object | No | Survey display settings including language and custom text |
| `writeKey` | string | Yes | Project Write Key from SatisMeter |

#### 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 Unsubscribed Emails

**Slug:** `SATISMETER_GET_UNSUBSCRIBED_EMAILS`

Tool to retrieve list of unsubscribed emails for a project. Use when you need to fetch emails that have opted out of surveys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique ID of the project to retrieve unsubscribed emails for. This is the Project ID found in Settings > Integrations > API in your SatisMeter dashboard (24-character MongoDB ObjectID format, e.g., '68877a5547d1914b110d41bd'). |

#### 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 |

### List Surveys

**Slug:** `SATISMETER_LIST_SURVEYS`

Tool to list surveys (campaigns) in a project. Use when you have a valid project ID and need to retrieve its surveys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project` | string | Yes | SatisMeter project ID (24-character hex string). Obtain from your connected SatisMeter account or from the SatisMeter dashboard under Project Settings. Do not use project names. |

#### 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 |

### List Users

**Slug:** `SATISMETER_LIST_USERS`

Tool to list users in a project. Use when you have a valid project ID and need to retrieve its users. Optionally filter by a specific user ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project` | string | Yes | ID of the project to list users for |
| `user_id` | string | No | Filter by specific user ID (the id passed on the widget) to return only that user |

#### 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 |

### Update Unsubscribed Emails

**Slug:** `SATISMETER_UPDATE_UNSUBSCRIBED_EMAILS`

Tool to update the list of unsubscribed emails for a project. Use when you need to bulk unsubscribe user emails from surveys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email addresses to unsubscribe. |
| `project_id` | string | Yes | ID of the Satismeter project (24-character MongoDB ObjectId format). |

#### 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 |