---
title: Web Service
description: Learn how to use the Web Service system utility app in APIANT to create automations that not only receive data instantly via a URL but also return output responses back to the calling system.
---

[Skip to content](https://help.apiant.com/web-service#main-content)

English

Show submenu for translations

![apiant-logo-forum.png\]](https://help.apiant.com/hs-fs/hubfs/apiant-logo-forum.png?height=40&name=apiant-logo-forum.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to apiant.com

 Go to apiant.com

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.apiant.com/?hsLang=en)
2. [AutomationEditor](https://help.apiant.com/automationeditor?hsLang=en)
3. [Building Automations](https://help.apiant.com/automationeditor?hsLang=en#building-automations)

# Web Service

## Learn how to use the Web Service system utility app in APIANT to create automations that not only receive data instantly via a URL but also return output responses back to the calling system.

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 [Web Services](https://help.apiant.com/web-services?hsLang=en)

The Web Service system utility app provides a single trigger for receiving input data from the calling system:

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/dJppFQiBJ-3M6URl6wFmd_image.png?format=webp)

 

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.

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/6KPJIptYd2cSiOris1vHW_image.png?format=webp)

 

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.

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/aqj_qh_nZhTl8XEJ6t4nb_image.png?format=webp)

 

Build the logic of your automation normally. To return output data back to the calling system, use the "return HTTP response" action:

 

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/zF8vmvf3YTyl9wDKcR6NR_image.png?format=webp)

 

Configure an HTTP status code to return and the response data to return back to the caller.

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/eVeRDASFnnLcDZmbVB_cp_image.png?format=webp)

 

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 [here](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:

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/JHwhdlypVyt0Ho71qBjng_image.png?format=webp)

 

Clicking it generates a curl command that can be used to test the web service automation:

![Document image](https://images.archbee.com/Y2QGD8otsIOv4e0hQQnqa/L3Q1u8plf2ciWGwk5QpUW_image.png?format=webp)

 

The curl command includes any query parameters and POST payload configured in the web service trigger.

- [ZoomConnect](https://help.apiant.com/zoomconnect?hsLang=en)
- [ShopConnect](https://help.apiant.com/shopconnect?hsLang=en)
- [AppConnect](https://help.apiant.com/appconnect?hsLang=en#main-content)

    - [AppConnectPrebuiltConnectors](https://help.apiant.com/appconnect?hsLang=en#appconnectprebuiltconnectors)
- [CalendarConnect](https://help.apiant.com/calendarconnect?hsLang=en)
- [CRMConnect](https://help.apiant.com/crmconnect?hsLang=en#main-content)

    - [Mindbody to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-hubspot)
    - [Cliniko to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-hubspot)
    - [Cliniko to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-activecampaign)
    - [DonorPerfect to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-hubspot)
    - [DonorPerfect to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-activecampaign)
    - [Mindbody to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-activecampaign)
- [MailConnect](https://help.apiant.com/mailconnect?hsLang=en)
- [AutomationEditor](https://help.apiant.com/automationeditor?hsLang=en#main-content)

    - [KeyConcepts](https://help.apiant.com/automationeditor?hsLang=en#keyconcepts)
    - [AccountManagement](https://help.apiant.com/automationeditor?hsLang=en#accountmanagement)
    - [ManagingAutomations](https://help.apiant.com/automationeditor?hsLang=en#managingautomations)
    - [App Connections](https://help.apiant.com/automationeditor?hsLang=en#app-connections)
    - [Building Automations](https://help.apiant.com/automationeditor?hsLang=en#building-automations)
- [APIANTforBuilders](https://help.apiant.com/apiantforbuilders?hsLang=en)
- [APIANTInline](https://help.apiant.com/apiantinline?hsLang=en)
- [WhatisAPIANT?](https://help.apiant.com/whatisapiant?hsLang=en)
- [ContactAPIANTsupport](https://help.apiant.com/contactapiantsupport?hsLang=en)

[![APIANT](https://help.apiant.com/hubfs/APIANT_LOGO-2.svg "APIANT")](http://apiant.com)

apiant.com Help Center

Copyright © 2026, APIANT