> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Simplesat

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

![Simplesat logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/simplesat.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=fd8a479ff4b26a200f7a27b4d2ea6f9c)

* **Category:** crm
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `SIMPLESAT`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **name** `string`
>
> Full name of the customer
>
> **tags** `array`
>
> Array of tag strings to associate with the customer
>
> **email** `string` *required*
>
> Email address of the customer (used as unique identifier)
>
> **company** `string`
>
> Company name of the customer
>
> **external\_id** `string`
>
> External ID for the customer from your system for integrations with other systems
>
> **custom\_attributes** `object`
>
> Object with custom attribute key-value pairs. Any custom attribute fields that didn't previously exist will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string` *required*
>
> Email address of the team member
>
> **phone** `string`
>
> Phone number of the team member
>
> **title** `string`
>
> Job title of the team member
>
> **last\_name** `string` *required*
>
> Last name of the team member
>
> **first\_name** `string` *required*
>
> First name of the team member
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `string` *required*
>
> Unique identifier of the customer in Simplesat
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Answers
>
> **Slug:** `SIMPLESAT_LIST_ANSWERS`
>
> List Simplesat answers with question, customer and ticket details, with modified-date filters and pagination. This tool is deprecated.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (starts at 1)
>
> **page\_size** `integer`
>
> Number of records per page (default 100)
>
> **modified\_\_gte** `string`
>
> Filter answers modified after a date (ISO 8601 format, e.g., '2024-01-01T00:00:00Z')
>
> **modified\_\_lte** `string`
>
> Filter answers modified before a date (ISO 8601 format, e.g., '2024-12-31T23:59:59Z')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page number for pagination (starts at 1)
>
> **metric** `string ("csat" | "nps" | "ces")`
>
> Metric type enum for filtering questions.
>
> **page\_size** `integer`
>
> Number of records per page (default 100)
>
> **survey\_id** `integer`
>
> Filter questions by survey ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Surveys
>
> **Slug:** `SIMPLESAT_LIST_SURVEYS`
>
> List a page of surveys in the Simplesat account, returning each survey's ID, name and metric type. Use pagination to retrieve additional surveys or find a survey by name or metric type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (must be positive integer)
>
> **page\_size** `integer`
>
> Number of records per page (default 100, max 100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page number for pagination (starts at 1)
>
> **filters** `array`
>
> 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`
>
> 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")`
>
> Operator to apply between multiple filters.
>
> **page\_size** `integer`
>
> Number of records per page (default 100)
>
> **start\_date** `string`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Responses
>
> **Slug:** `SIMPLESAT_SEARCH_RESPONSES`
>
> Search Simplesat responses by date range and filters such as choice value, customer, sentiment, survey, team member or ticket ID. Supports pagination; if no date range is specified, responses default to the last 30 days.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination. Starts at 1.
>
> **filters** `array`
>
> Array of filter objects to narrow down responses by specific criteria such as sentiment, customer, team member, survey, etc.
>
> **end\_date** `string`
>
> 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")`
>
> Operator to combine multiple filters.
>
> **page\_size** `integer`
>
> Number of records per page. Default is 100, maximum is 100.
>
> **start\_date** `string`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `string` *required*
>
> The unique identifier of the customer to update
>
> **name** `string`
>
> Full name of the customer
>
> **tags** `array`
>
> Array of tags associated with the customer
>
> **email** `string`
>
> Email address of the customer
>
> **company** `string`
>
> Company name of the customer
>
> **external\_id** `integer`
>
> External identifier for the customer
>
> **custom\_attributes** `object`
>
> Custom attributes as key-value pairs. Any custom attribute fields that didn't previously exist will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
