HTTP Targets

When a participant submits a response to your project, HTTP Targets allow you to pass values from a response to a third-party application, using their REST APIs.

Here’s how it works:

1. Within your SoGoSurvey account, click on the Utilities icon in the top right corner.
2. Click Integrations.
3. Click Create HTTP Target.
   
4. Next, select the project on which you want to apply the HTTP Target and name the rule for your internal reference. Click Continue.
   
5. You will be redirected to Rules & Alerts to complete this set-up. By default, the selected triggering event is Survey Response Received. If you need to trigger this HTTP Target based on some other conditions, visit the Details step of the wizard and make changes.
6. In the URL section, enter the third-party REST API’s endpoint URL.
7. Select the method. Methods can be POST or PUT.
8. Next, in Content type, select JSON or XML.
   
9. Based on your Content type selection, click on Input JSON/XML tab. You will have an option to enter the JSON/XML. In the Response Variables tab you may copy and replace response variables in the JSON/XML.
   
10. Turn on Authentication, if the REST API requires it, and enter username and password.
    
11. Test the Target, then click Continue.
12. Save the rule by clicking Done on the next step.
13. When you revisit HTTP Target, you’ll see the list of all targets created for each project. You may also create additional targets by clicking Create HTTP Target.
    

All HTTP Targets are executed when responses are received.