Skip to main content
Simplesat logo
  • Category: crm
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: SIMPLESAT
  • Version: 20261101_00

Tools

Slug: SIMPLESAT_CREATE_OR_UPDATE_CUSTOMER2Tool 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

string
Full name of the customer
array
Array of tag strings to associate with the customer
string
required
Email address of the customer (used as unique identifier)
string
Company name of the customer
string
External ID for the customer from your system for integrations with other systems
object
Object with custom attribute key-value pairs. Any custom attribute fields that didn’t previously exist will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_CREATE_OR_UPDATE_TEAM_MEMBERThis 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

string
required
Email address of the team member
string
Phone number of the team member
string
Job title of the team member
string
required
Last name of the team member
string
required
First name of the team member

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_GET_CUSTOMERTool to retrieve a single customer by their Simplesat ID. Returns customer details including name, email, company, tags, and custom attributes.

Input Parameters

string
required
Unique identifier of the customer in Simplesat

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_LIST_ANSWERSList Simplesat answers with question, customer and ticket details, with modified-date filters and pagination. This tool is deprecated.

Input Parameters

integer
Page number for pagination (starts at 1)
integer
Number of records per page (default 100)
string
Filter answers modified after a date (ISO 8601 format, e.g., ‘2024-01-01T00:00:00Z’)
string
Filter answers modified before a date (ISO 8601 format, e.g., ‘2024-12-31T23:59:59Z’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_LIST_QUESTIONSTool 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

integer
Page number for pagination (starts at 1)
string ("csat" | "nps" | "ces")
Metric type enum for filtering questions.
integer
Number of records per page (default 100)
integer
Filter questions by survey ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_LIST_SURVEYSList 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

integer
Page number for pagination (must be positive integer)
integer
Number of records per page (default 100, max 100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_SEARCH_ANSWERSTool 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

integer
Page number for pagination (starts at 1)
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.
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.
string ("and" | "or")
Operator to apply between multiple filters.
integer
Number of records per page (default 100)
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_SEARCH_RESPONSESSearch 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

integer
Page number for pagination. Starts at 1.
array
Array of filter objects to narrow down responses by specific criteria such as sentiment, customer, team member, survey, etc.
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.
string ("and" | "or")
Operator to combine multiple filters.
integer
Number of records per page. Default is 100, maximum is 100.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIMPLESAT_UPDATE_CUSTOMERTool 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

string
required
The unique identifier of the customer to update
string
Full name of the customer
array
Array of tags associated with the customer
string
Email address of the customer
string
Company name of the customer
integer
External identifier for the customer
object
Custom attributes as key-value pairs. Any custom attribute fields that didn’t previously exist will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not