Web Service

a web service is similar to a webhook in that other systems can trigger the execution of automations instantly when specific events occur by sending data to a specified url unlike webhooks, a web service automation can return output data from the automation back to the caller that invoked the url the caller waits until the web service automation returns its output data it is also possible to build web service assemblies with the assembly editor, see docid\ ghowchrsukqwbybasyx85 the web service system utility app provides a single trigger for receiving input data from the calling system a web service receives data via a specified url the web service can be configured to receive url query parameters by entering one or more query parameter names the web service can also be configured to receive a post payload if json or xml is entered, the system will automatically parse it and create mappable data fields as output from the trigger that can be mapped to actions in the automation after configuring the inputs, click the fetch data fields button the system will then display the web service's url click the copy icon to copy the url to your clipboard and provide that to the calling system build the logic of your automation normally to return output data back to the calling system, use the "return http response" action configure an http status code to return and the response data to return back to the caller this action can be used to return error responses back to the caller generally error responses use http status codes >= 400 for an explanation of http status codes, see https //developer mozilla org/en us/docs/web/http/status your automation logic should only execute a single "return http response" action if multiple of these are executed, the last one takes precedence if other actions in the automation raise an error, the system automatically halts the automation and returns an error response back to the caller with the error message logged by the automation web service automations do not perform auto retry logic for any failed actions that are normally configured to be auto retried, b/c the caller system is expecting an immediate response from the web service it would be up to the calling system to determine if it wants to retry the failure or not web service automations in the dashboard will display the execute icon clicking it generates a curl command that can be used to test the web service automation the curl command includes any query parameters and post payload configured in the web service trigger