Share via


SimpleSurvey (Preview)

With this connector, you can easily connect to your SimpleSurvey projects to access survey data, automate workflows, and stay informed through event-driven triggers. Whether you’re measuring employee engagement, tracking customer satisfaction, or managing registration processes, SimpleSurvey helps you centralize insights and take action faster.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name SimpleSurvey Support
URL https://simplesurvey.com/contact
Email support@simplesurvey.com
Connector Metadata
Publisher SimpleSurvey
Website https://simplesurvey.com/
Privacy policy https://form.simplesurvey.com/oss/external/privacypolicy.aspx?lang=EN
Categories Data;Communication

SimpleSurvey Connector

With this connector, you can easily connect to your SimpleSurvey projects to access survey data, automate workflows, and stay informed through event-driven triggers. Whether you're measuring employee engagement, tracking customer satisfaction, or managing registration processes, SimpleSurvey helps you centralize insights and take action faster.

Prerequisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan with custom connector feature
  • A valid SimpleSurvey subscription with the Power Apps integration and shared access key features enabled
  • Your account's Power Apps API Key

Supported Operations

The connector supports the following operations:

  • Get surveys: Lists all your eligible surveys.
  • Get survey respondents details in JSON or CSV format: Gets specific details about your survey respondents in the selected format.
  • Schedule a task: Schedule an automated task in SimpleSurvey.
  • Get your survey data warehouse report in JSON or CSV format: Gets all data about your survey respondents and their responses in the selected format.
  • Get your project's statistics: Gets your project's latest insights.

Supported Triggers

  • When a response is submitted: Programs a flow to run when a response is received in your survey.
  • When a response is changed: Programs a flow to run when a response is modified in your survey.

Known Issues and Limitations

  • Not all types of scheduled tasks are available to this connector.
  • The datetime format supported by this connector is: yyyy-MM-dd HH:mm

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
api_key securestring The api_key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get Survey Respondents Details in JSON or CSV format

Get details about survey respondents in JSON or CSV format

Get surveys

Get all eligible surveys.

Get your project's statistics

Get your project's statistics

Get your survey Datawarehouse report in JSON or CSV format

Get your survey Datawarehouse report in JSON or CSV format

Schedule a task

Schedule an automatic task for your survey

Get Survey Respondents Details in JSON or CSV format

Get details about survey respondents in JSON or CSV format

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

Get details about
tableCode True string

The details to get

The format of the returned data
format True string

Must be JSON or CSV

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

Returns

Name Path Type Description
respondentsTable
respondentsTable array of object

respondentsTable

respondent_id
respondentsTable.respondent_id string

respondent_id

ip
respondentsTable.ip string

ip

respondentsTable.internal_id integer

internal_id

info1
respondentsTable.info1 string

info1

info2
respondentsTable.info2 string

info2

info3
respondentsTable.info3 string

info3

info4
respondentsTable.info4 string

info4

info5
respondentsTable.info5 string

info5

browser
respondentsTable.browser string

browser

platform
respondentsTable.platform string

platform

is_mobile
respondentsTable.is_mobile boolean

is_mobile

referer_url
respondentsTable.referer_url string

referer_url

confirmation_number
respondentsTable.confirmation_number string

confirmation_number

created_date_utc
respondentsTable.created_date_utc string

created_date_utc

first_answer_date_utc
respondentsTable.first_answer_date_utc string

first_answer_date_utc

last_answer_date_utc
respondentsTable.last_answer_date_utc string

last_answer_date_utc

submitted_date_utc
respondentsTable.submitted_date_utc string

submitted_date_utc

last_savecont_date_utc
respondentsTable.last_savecont_date_utc string

last_savecont_date_utc

lang_code
respondentsTable.lang_code string

lang_code

lang_localized
respondentsTable.lang_localized string

lang_localized

respondentsTable.score float

score

respondentsTable.score_auto float

score_auto

respondentsTable.score_manual float

score_manual

completion_time
respondentsTable.completion_time integer

completion_time

title
respondentsTable.title string

title

mobile
respondentsTable.mobile string

mobile

organization
respondentsTable.organization string

organization

segment
respondentsTable.segment string

segment

location
respondentsTable.location string

location

first_name
respondentsTable.first_name string

first_name

last_name
respondentsTable.last_name string

last_name

email
respondentsTable.email string

email

state_code
respondentsTable.state_code string

state_code

state_localized
respondentsTable.state_localized string

state_localized

group
respondentsTable.group string

group

workspace
respondentsTable.workspace string

workspace

collector_code
respondentsTable.collector_code string

collector_code

pin
respondentsTable.pin string

pin

caseTable
caseTable array of object

caseTable

respondent_id
caseTable.respondent_id string

respondent_id

element_id
caseTable.element_id string

element_id

variable_id
caseTable.variable_id string

variable_id

column_id
caseTable.column_id string

column_id

sub_element
caseTable.sub_element integer

sub_element

value
caseTable.value string

value

variableTable
variableTable array of object

variableTable

element_id
variableTable.element_id string

element_id

variable_id
variableTable.variable_id string

variable_id

column_id
variableTable.column_id string

column_id

sub_element
variableTable.sub_element integer

sub_element

element_label
variableTable.element_label string

element_label

variable_label
variableTable.variable_label string

variable_label

column_label
variableTable.column_label string

column_label

sub_element_label
variableTable.sub_element_label string

sub_element_label

description
variableTable.description string

description

variableValueLabelTable
variableValueLabelTable array of object

variableValueLabelTable

element_id
variableValueLabelTable.element_id string

element_id

variable_id
variableValueLabelTable.variable_id string

variable_id

column_id
variableValueLabelTable.column_id string

column_id

sub_element
variableValueLabelTable.sub_element integer

sub_element

description
variableValueLabelTable.description string

description

label
variableValueLabelTable.label string

label

genericFieldHeaderTable
genericFieldHeaderTable array of object

genericFieldHeaderTable

generic_field_id
genericFieldHeaderTable.generic_field_id integer

generic_field_id

code
genericFieldHeaderTable.code string

code

name
genericFieldHeaderTable.name string

name

genericFieldDataTable
genericFieldDataTable array of object

genericFieldDataTable

generic_field_id
genericFieldDataTable.generic_field_id integer

generic_field_id

respondent_id
genericFieldDataTable.respondent_id string

respondent_id

value
genericFieldDataTable.value string

value

genericFieldDataTable_csv
genericFieldDataTable_csv string

genericFieldDataTable_csv

genericFieldHeaderTable_csv
genericFieldHeaderTable_csv string

genericFieldHeaderTable_csv

respondentsTable_csv
respondentsTable_csv string

respondentsTable_csv

caseTable_csv
caseTable_csv string

caseTable_csv

variableTable_csv
variableTable_csv string

variableTable_csv

variableValueLabelTable_csv
variableValueLabelTable_csv string

variableValueLabelTable_csv

Get surveys

Get all eligible surveys.

Returns

Name Path Type Description
value
value array of object

value

display_name
value.display_name string

display_name

id
value.id string

id

sharedKey
value.sharedKey string

sharedKey

success
success boolean

success

errormsg
errormsg string

errormsg

errordetails
errordetails string

errordetails

errorcode
errorcode string

errorcode

context
context string

context

Get your project's statistics

Get your project's statistics

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

Force recompilation of statistics?
f True boolean

Set this value to force the recompilaion of statistics

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

Returns

Name Path Type Description
AssignedCount integer

AssignedCount

AssignedContactCount integer

AssignedContactCount

AssignedDistributionListMemberCount integer

AssignedDistributionListMemberCount

AssignedNoInviteDeliveredCount integer

AssignedNoInviteDeliveredCount

EligibleContactCount integer

EligibleContactCount

InviteSentCount
InviteSentCount integer

InviteSentCount

InviteBouncedCount
InviteBouncedCount integer

InviteBouncedCount

InviteBounceRate
InviteBounceRate float

InviteBounceRate

InviteDeliveredCount
InviteDeliveredCount integer

InviteDeliveredCount

InviteDeliveryRate
InviteDeliveryRate float

InviteDeliveryRate

InviteOpenedCount
InviteOpenedCount integer

InviteOpenedCount

InviteOpenRate
InviteOpenRate float

InviteOpenRate

UnsubscribedCount
UnsubscribedCount integer

UnsubscribedCount

UnsubscribeRate
UnsubscribeRate float

UnsubscribeRate

InviteDeliveredNoAccessCount
InviteDeliveredNoAccessCount integer

InviteDeliveredNoAccessCount

EmptyCount
EmptyCount integer

EmptyCount

EmptyPercentage
EmptyPercentage float

EmptyPercentage

AccessedCount integer

AccessedCount

RespondedCount
RespondedCount integer

RespondedCount

InProgressCount
InProgressCount integer

InProgressCount

CompletedCount integer

CompletedCount

ClosedCount integer

ClosedCount

InProgressPercentage
InProgressPercentage float

InProgressPercentage

CompletedPercentage
CompletedPercentage float

CompletedPercentage

ClosedPercentage
ClosedPercentage float

ClosedPercentage

CompletionRate_CompletedOverResponded
CompletionRate_CompletedOverResponded float

CompletionRate_CompletedOverResponded

CompletionRate_CompletedOverAccessed
CompletionRate_CompletedOverAccessed float

CompletionRate_CompletedOverAccessed

ResponseRate_RespondedOverAssigned
ResponseRate_RespondedOverAssigned float

ResponseRate_RespondedOverAssigned

ResponseRate_CompletedOverAssigned
ResponseRate_CompletedOverAssigned float

ResponseRate_CompletedOverAssigned

ResponseRate_RespondedOverInvited
ResponseRate_RespondedOverInvited float

ResponseRate_RespondedOverInvited

ResponseRate_CompletedOverInvited
ResponseRate_CompletedOverInvited float

ResponseRate_CompletedOverInvited

CompletionTime_Avg
CompletionTime_Avg integer

CompletionTime_Avg

CompletionTime_Med
CompletionTime_Med integer

CompletionTime_Med

OptInConfirmationCount
OptInConfirmationCount integer

OptInConfirmationCount

EmailSentCount
EmailSentCount integer

EmailSentCount

SMSSentCount
SMSSentCount integer

SMSSentCount

LastCompletedDate
LastCompletedDate string

LastCompletedDate

LastUpdatedDate
LastUpdatedDate string

LastUpdatedDate

CompletedCountPerDayString
CompletedCountPerDayString string

CompletedCountPerDayString

CompletedCountPerDay
CompletedCountPerDay array of object

CompletedCountPerDay

CompletedCountPerDay.timestamp integer

timestamp

count
CompletedCountPerDay.count integer

count

CompletedCountPerMonthString
CompletedCountPerMonthString string

CompletedCountPerMonthString

CompletedCountPerMonth
CompletedCountPerMonth array of object

CompletedCountPerMonth

CompletedCountPerMonth.timestamp integer

timestamp

count
CompletedCountPerMonth.count integer

count

success
success boolean

success

Get your survey Datawarehouse report in JSON or CSV format

Get your survey Datawarehouse report in JSON or CSV format

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

The format of the returned data
format True string

Must be JSON or CSV

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

Returns

Name Path Type Description
DatawarehouseRpt
DatawarehouseRpt array of object

DatawarehouseRpt

QuestionProgId
DatawarehouseRpt.QuestionProgId string

QuestionProgId

Question
DatawarehouseRpt.Question string

Question

Response
DatawarehouseRpt.Response string

Response

Comment
DatawarehouseRpt.Comment string

Comment

SubQuestion
DatawarehouseRpt.SubQuestion string

SubQuestion

Score
DatawarehouseRpt.Score float

Score

Date_Time
DatawarehouseRpt.Date_Time string

Date_Time

Status
DatawarehouseRpt.Status string

Status

DatawarehouseRpt.InternalID integer

InternalID

Language
DatawarehouseRpt.Language string

Language

CreatedAt
DatawarehouseRpt.CreatedAt string

CreatedAt

UpdatedAt
DatawarehouseRpt.UpdatedAt string

UpdatedAt

Location
DatawarehouseRpt.Location string

Location

GETVariables
DatawarehouseRpt.GETVariables string

GETVariables

Referrer
DatawarehouseRpt.Referrer string

Referrer

WeightedScore
DatawarehouseRpt.WeightedScore float

WeightedScore

IPAddress
DatawarehouseRpt.IPAddress string

IPAddress

BrowserName
DatawarehouseRpt.BrowserName string

BrowserName

OperatingSystem
DatawarehouseRpt.OperatingSystem string

OperatingSystem

InviteCode
DatawarehouseRpt.InviteCode string

InviteCode

InviteEmail
DatawarehouseRpt.InviteEmail string

InviteEmail

InviteName
DatawarehouseRpt.InviteName string

InviteName

Collector
DatawarehouseRpt.Collector string

Collector

DatawarehouseRpt_csv
DatawarehouseRpt_csv string

DatawarehouseRpt_csv

Schedule a task

Schedule an automatic task for your survey

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

type
type True integer

Task type

description
description True string

Task Description

date
date True date-time

Execution Date (format: yyyy-MM-dd HH:mm)

idOtherSurvey
idSurveyFrom string

Project to assign to (Set for types 6 & 7)

allParticipants
allParticipants boolean

Send To (Set for types 10X & 14)

communicationMode
communicationMode string

Communication Mode (Set only for "mass reminder" and "initial invitation" tasks)

idAssignationGroup
idAssignationGroup string

Target only members of the following groups (Optionally set for types 101 to 105)

idContactGroup
idContactGroup string

Contact Group Name (Set for type 3)

Returns

Name Path Type Description
success
success boolean

success

errormsg
errormsg string

errormsg

successmsg
successmsg string

successmsg

Triggers

When a response is changed

When a response is changed

When a response is submitted

When a response is submitted

When a response is changed

When a response is changed

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

The target communication workflow
automationId True integer

The target communication workflow

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

Name
Name True string

Name

When a response is submitted

When a response is submitted

Parameters

Name Key Required Type Description
The survey
idProject True string

Select a survey

The target communication workflow
automationId True integer

The target communication workflow

Enter your shared access key for this survey
X-SAKKey True string

Must your key for the selected survey

Name
Name True string

Name