← Tools Reference

Simplesat

Simplesat integration (Marketing, Data). Imported from open-connector.

API key8 toolshttps://api.simplesat.io
GET
simplesat_list_surveys
List one page of Simplesat surveys.

/api/v1/surveys

2 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe one-based page number to request from Simplesat.
pageSizeintegeroptionalThe number of records to request per page.
GET
simplesat_list_questions
List one page of Simplesat questions with optional survey and metric filters.

/api/v1/questions

4 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe one-based page number to request from Simplesat.
pageSizeintegeroptionalThe number of records to request per page.
surveyIdintegeroptionalFilter questions by Simplesat survey ID.
metricstringoptionalFilter questions by metric, such as csat, nps, or ces.
POST
simplesat_search_responses
Search one page of Simplesat survey responses with documented date and field filters.

/api/v1/responses/search

10 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe one-based page number to request from Simplesat.
pageSizeintegeroptionalThe number of records to request per page.
startDatestringoptionalLegacy response search start timestamp accepted by Simplesat.
endDatestringoptionalLegacy response search end timestamp accepted by Simplesat.
createdStartDatestringoptionalFilter responses created on or after this timestamp.
createdEndDatestringoptionalFilter responses created on or before this timestamp.
modifiedStartDatestringoptionalFilter responses modified on or after this timestamp.
modifiedEndDatestringoptionalFilter responses modified on or before this timestamp.
operatorstringoptionalHow Simplesat should combine multiple response filters.
filtersarrayoptionalResponse filters to apply.
GET
simplesat_get_response
Get a single Simplesat survey response by ID.

/api/v1/responses/{responseId}

1 parameter
ParamTypeRequiredDescription
responseIdstringrequiredThe Simplesat response ID to retrieve.
GET
simplesat_list_customers
List one page of Simplesat customers with optional date and subscription filters.

/api/v1/customers

7 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe one-based page number to request from Simplesat.
pageSizeintegeroptionalThe number of customers to request per page.
createdAfterstringoptionalFilter customers created after this timestamp.
createdBeforestringoptionalFilter customers created before this timestamp.
modifiedAfterstringoptionalFilter customers modified after this timestamp.
modifiedBeforestringoptionalFilter customers modified before this timestamp.
subscribedbooleanoptionalFilter customers by subscription status.
GET
simplesat_get_customer
Get a single Simplesat customer by ID.

/api/v1/customers/{customerId}

1 parameter
ParamTypeRequiredDescription
customerIdstringrequiredThe Simplesat customer ID to retrieve.
POST
simplesat_create_or_update_customer
Create or update a Simplesat customer by email, overwriting tags or custom attributes when provided.

/api/v1/customers

7 parameters
ParamTypeRequiredDescription
externalIdstringoptionalThe customer identifier from an external system.
emailstringrequiredThe customer email address.
namestringoptionalThe customer full name.
companystringoptionalThe customer company name.
languagestringoptionalThe customer language code.
tagsarrayoptionalTags associated with the Simplesat record.
customAttributesobjectoptionalCustom attributes keyed by Simplesat attribute name.
POST
simplesat_send_survey_email
Schedule a Simplesat event-based survey email for a customer with optional team member and ticket metadata.

/api/v1/surveys/{surveyToken}/email

4 parameters
ParamTypeRequiredDescription
surveyTokenstringrequiredThe event-based Simplesat survey token to send.
customerobjectrequiredThe customer who should receive the survey email.
teamMemberobjectoptionalThe team member metadata to associate with the survey email.
ticketobjectoptionalThe ticket metadata to associate with the survey email.