# Simplesat

Simplesat captures customer feedback and CSAT scores through surveys, integrating directly with helpdesk systems for real-time performance insights

- **Category:** crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `SIMPLESAT`
- **Version:** 20260225_00

## Tools

### Create or Update Customer V2

**Slug:** `SIMPLESAT_CREATE_OR_UPDATE_CUSTOMER2`

Tool to create a new customer or update an existing customer if one already exists with the same email. Use when you need to add or modify customer information including name, email, company, tags, external_id, and custom attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Full name of the customer |
| `tags` | array | No | Array of tag strings to associate with the customer |
| `email` | string | Yes | Email address of the customer (used as unique identifier) |
| `company` | string | No | Company name of the customer |
| `external_id` | string | No | External ID for the customer from your system for integrations with other systems |
| `custom_attributes` | object | No | Object with custom attribute key-value pairs. Any custom attribute fields that didn't previously exist will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Create or Update Team Member

**Slug:** `SIMPLESAT_CREATE_OR_UPDATE_TEAM_MEMBER`

This tool creates a new team member or updates an existing one if a team member with the same email address is found. It is an independent action that requires only basic team member information (email, first_name, last_name, and optionally title and phone) and does not depend on any other resource IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the team member |
| `phone` | string | No | Phone number of the team member |
| `title` | string | No | Job title of the team member |
| `last_name` | string | Yes | Last name of the team member |
| `first_name` | string | Yes | First name of the team member |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Customer

**Slug:** `SIMPLESAT_GET_CUSTOMER`

Tool to retrieve a single customer by their Simplesat ID. Returns customer details including name, email, company, tags, and custom attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the customer in Simplesat |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Answers

**Slug:** `SIMPLESAT_LIST_ANSWERS`

Tool to fetch a list of all answers from Simplesat. Returns answers with detailed question, customer, ticket, and team member information. Supports filtering by modified date and pagination. Note: This endpoint is deprecated; the v1 API POST /api/v1/answers/search is recommended instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1) |
| `page_size` | integer | No | Number of records per page (default 100) |
| `modified__gte` | string | No | Filter answers modified after a date (ISO 8601 format, e.g., '2024-01-01T00:00:00Z') |
| `modified__lte` | string | No | Filter answers modified before a date (ISO 8601 format, e.g., '2024-12-31T23:59:59Z') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Questions

**Slug:** `SIMPLESAT_LIST_QUESTIONS`

Tool to retrieve a paginated list of all questions in Simplesat. Use when you need to fetch question details including order, metric type, text, rating scale, choices, and conditional rules. Supports filtering by metric (csat, nps, ces) and survey_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1) |
| `metric` | string ("csat" | "nps" | "ces") | No | Metric type enum for filtering questions. |
| `page_size` | integer | No | Number of records per page (default 100) |
| `survey_id` | integer | No | Filter questions by survey ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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:** `SIMPLESAT_LIST_SURVEYS`

Tool to list all surveys in the Simplesat account. Returns survey details including id, name, and metric type (CSAT, NPS, CES). Use when you need to retrieve available surveys or find a specific survey by name or metric type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (must be positive integer) |
| `page_size` | integer | No | Number of records per page (default 100, max 100) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Search Answers

**Slug:** `SIMPLESAT_SEARCH_ANSWERS`

Tool to search and retrieve answers from Simplesat with advanced filtering. Use when you need to find specific answers based on filters like date range, choice value, sentiment, survey, customer, or custom attributes. If no filters are provided, returns all answers from the last 30 days by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1) |
| `filters` | array | No | Array of filter objects to apply. Each filter has a key (field to filter), values (array of values to match), and comparison operator. Supports filtering by choice_value, collaborator, company, comment, customer, sentiment, metric, survey, tag, team_member, and custom attributes. |
| `end_date` | string | No | End date and time in ISO 8601 format to filter answers (e.g., '2024-12-31T23:59:59Z'). If not specified, defaults to current date. |
| `operator` | string ("and" | "or") | No | Operator to apply between multiple filters. |
| `page_size` | integer | No | Number of records per page (default 100) |
| `start_date` | string | No | Start date and time in ISO 8601 format to filter answers (e.g., '2024-01-01T00:00:00Z'). If not specified, defaults to 30 days ago. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Search Responses

**Slug:** `SIMPLESAT_SEARCH_RESPONSES`

Tool to search and retrieve responses from Simplesat by applying specific filters. Returns all responses from the last 30 days by default if no date range is specified. Supports filtering by date range, choice value, collaborator, company, comment, customer, sentiment, metric, survey, tag, team member, ticket_id, and custom attributes. Use this when you need to find specific responses based on criteria like sentiment, customer, or time period.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Starts at 1. |
| `filters` | array | No | Array of filter objects to narrow down responses by specific criteria such as sentiment, customer, team member, survey, etc. |
| `end_date` | string | No | The date and time in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) to end displaying responses. If not specified, defaults to current date/time. |
| `operator` | string ("and" | "or") | No | Operator to combine multiple filters. |
| `page_size` | integer | No | Number of records per page. Default is 100, maximum is 100. |
| `start_date` | string | No | The date and time in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) to start displaying responses. If not specified, defaults to 30 days ago. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Customer

**Slug:** `SIMPLESAT_UPDATE_CUSTOMER`

Tool to update an existing customer by their Simplesat ID. Use when you need to modify customer information such as name, email, company, external ID, tags, or custom attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the customer to update |
| `name` | string | No | Full name of the customer |
| `tags` | array | No | Array of tags associated with the customer |
| `email` | string | No | Email address of the customer |
| `company` | string | No | Company name of the customer |
| `external_id` | integer | No | External identifier for the customer |
| `custom_attributes` | object | No | Custom attributes as key-value pairs. Any custom attribute fields that didn't previously exist will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |
