Survey123

ArcGIS Survey123 is a simple and intuitive form-centric data gathering solution that makes creating, sharing, and analyzing surveys possible in just three easy steps: 1) Ask Questions; 2) Get the Answers; 3) Make the best Decisions.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following:      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following:      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Survey123
URL	https://www.esri.com/survey123
Email	survey123@esri.com

Connector Metadata
Publisher	ArcGIS Survey123
Website	https://www.esri.com/survey123
Privacy policy	https://www.esri.com/en-us/privacy/overview
Categories	Website;Productivity

ArcGIS Survey123 lets you design location-aware smart forms for your organization and for the public, allowing people to submit data on the web or with the Survey123 field app. Survey123 is part of ArcGIS, bringing the power of location intelligence into your survey data. For more information, see the ArcGIS Survey123 Overview.

Prerequisites

• An ArcGIS organizational account is required. For more information, see Create account.
  • The Survey123 connector is designed to help you work with Survey123 surveys hosted in ArcGIS Online. If you want to use this connector with surveys hosted in ArcGIS Enterprise, please contact your Esri representative to discuss how Esri can help you configure your own custom Survey123 connector.
• You must be the owner of an ArcGIS Survey123 survey.

Get started

Once you have published your survey, you can familiarize yourself with this connector using templates from the gallery. Any data submitted through your form will be available in Microsoft Power Automate as dynamic content. You can even work with photos and signatures!

Considerations

You can only access surveys that you own.

By default, a flow is triggered when a survey response is submitted. To trigger a flow when a survey response is edited, go to the webhook settings for your survey on the Survey123 website. In the Trigger events section, enable the Existing record edited option. For more information on webhook settings, see Configure a webhook in the Survey123 website.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create report	Create report
Get surveys	This action retrieves a list of surveys owned by the logged in-user

Create report

Operation ID:

FeatureReportSubmitJob

Create report

Parameters

Name	Key	Required	Type	Description
Survey	surveyItemId	True	string	Survey
Feature layer	featureLayerUrl	True	string	Feature layer
Report template	templateItemId	True	string	Report template
Feature object ID	objectIds		string	Features to include in report. Use comma to separate multiple ObjectIDs
Feature WHERE clause	where		string	Features to include in report. A SQL WHERE clause to filter records
UTC offset	utcOffset		string	Apply an offset for your time zone, e.g. +02:00 or -09:00
Report name	outputReportName		string	Report name
Format	outputFormat		string	Format

Returns

Name	Path	Type	Description
jobId	jobId	string	jobId
jobStatus	jobStatus	string	jobStatus
submitted	submitted	integer	submitted
completed	completed	integer	completed
title	resultInfo.title	string	title
totalCount	resultInfo.totalCount	integer	totalCount
succeededObjectIds	resultInfo.succeededObjectIds	array of integer	succeededObjectIds
failedObjectIds	resultInfo.failedObjectIds	array of	failedObjectIds
details	resultInfo.details	array of	details
resultFiles	resultInfo.resultFiles	array of object	resultFiles
objectIds	resultInfo.resultFiles.objectIds	array of integer	objectIds
name	resultInfo.resultFiles.name	string	name
size	resultInfo.resultFiles.size	integer	size
status	resultInfo.resultFiles.status	string	status
url	resultInfo.resultFiles.url	string	url
objectIds	resultInfo.resultFile.objectIds	array of integer	objectIds in the first result file
name	resultInfo.resultFile.name	string	name of the first result file
size	resultInfo.resultFile.size	integer	size of the first result file
status	resultInfo.resultFile.status	string	status of the first result file
url	resultInfo.resultFile.url	string	url of the first result file
jobType	inputInfo.jobType	string	jobType
featureLayerUrl	inputInfo.parameters.featureLayerUrl	string	featureLayerUrl
objectIds	inputInfo.parameters.queryParameters.objectIds	string	objectIds
templateItemId	inputInfo.parameters.templateItemId	string	templateItemId
surveyItemId	inputInfo.parameters.surveyItemId	string	surveyItemId
portalUrl	inputInfo.parameters.portalUrl	string	portalUrl
outputFormat	inputInfo.parameters.outputFormat	string	outputFormat

Get surveys

Operation ID:

GetOwnedSurveyList

This action retrieves a list of surveys owned by the logged in-user

Returns

Triggers

When a survey response is submitted

Triggers a new flow when a survey response is submitted by a user

When a survey response is submitted

Operation ID:

AddData

Triggers a new flow when a survey response is submitted by a user

Parameters

Name	Key	Required	Type	Description
Survey	surveyId	True	string	Survey
events	events	True	array of string	events
Include portal info	includePortalInfo	True	boolean	Include the portal info in the payload, such as the portal URL.
Include user info	includeUserInfo	True	boolean	Include the user info in the payload, such as the user name, email address, first name and last name.
Include survey info	includeSurveyInfo	True	boolean	Include the survey info in the payload, such as the survey title and survey item id.
Include submitted record	includeServiceRequest	True	boolean	Include the submitted record info in the payload, such as attributes and geometry of the feature.
Include server response	includeServiceResponse	True	boolean	Include the raw server response in the payload.

Returns

The outputs of this operation are dynamic.