--- title: Web Request Quick Action slug: neurons-for-itsm/admin-user-help/enu/latest/web-request-quick-action createdAt: 2026-07-14T19:16:26.014Z --- - [About the Web Request Quick Action](docId\:y26u7cThGAHAnAdODezoG) - [Parameters](docId\:y26u7cThGAHAnAdODezoG) - Classic Action Designer: [Web Request Quick Action](docId\:DBkjmt27xWkLAH73d9ARo) You can use web requests to update fields in your business objects. Use the **Web Request** action when you need to customize and define inputs. The **Web Request **Quick Action uses open APIs to communicate with web servers, making it a flexible data gathering tool. ## About the Web Request Quick Action Use the **Web Request **Quick Action block to gather data and update fields in one step. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/kOV61XyrDzbI02K9bZbPg_qa-web-request-block-gad.png" alt="Image of the Web Request Quick Action block in the Graphical Action Designer" position="flex-start" size="40" initialPath="../../../../Resources/Images/help-images/qa web request block - gad.png" githubPath="Content/Resources/Images/help-images/qa web request block - gad.png" showCaption="false" width="359" height="95" darkWidth="359" darkHeight="95"} ## Parameters To access the parameters, select the **Action Block** to display them in the **Settings** pane. ### Action Block Settings ### General Settings **Block Label**: A unique name for the block. This is useful to identify each action when you have more than one of the same action block added or cloned in the design area. - **Method**: - GET: Gathers data from a resource on the server. - POST: Sends data to the server to create or update a resource. Multiple POST requests will result in compounded changes to the resource. - PUT: Sends data to the server to create or update a resource. Multiple PUT requests will result in the same response with every request. - PATCH: Applies partial modifications to a resource. - DELETE: Deletes the specified resource. - **URL**: The target of your web request. - **Body**: Enter the payload you are sending with your web request. - For example, $('\{"Status":"' + Status + '", "Subject":"' + Subject +'", "Description":"' + Symptom + '"}'). ### Header Settings The header settings contain metadata in key-value pairs that are sent along with HTTP requests. A request header is sent to the web server and contains information and instructions for the resource to respond to the request. You can find useful information on using HTTP headers at [https://blog.postman.com/what-are-http-headers/](https://blog.postman.com/what-are-http-headers/). You can specify one or more header key-value pairs in the **Header Settings**. See [Example of Header Settings](docId\:y26u7cThGAHAnAdODezoG) for typical examples of defining the header settings. 1. Click **Header Settings** to open the workspace in the **Graphical Action Designer**. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/LFNn2PdWdwNwf6x0FeUad_webrequestheadersettings.png" position="flex-start" size="40" initialPath="../../quick-actions-images/web_request_header_settings.png" githubPath="Content/Configure/QuickActions/quick-actions-images/web_request_header_settings.png" showCaption="false" width="809" height="138" darkWidth="809" darkHeight="138"} 2. Enter the required **Header Key** and **Header Value** pair. 3. Click the **+** icon to add more pairs. ### Example of Header Settings In this example, we define the header settings to pass an API key to a web server. Typically, this may be used to obtain data from the server, the header value API key being passed to the server as authorization to obtain the data. 1. Set the **Web Request** action's **Method** field to 'GET', as we want to gather data from a resource on the server. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/n8rDxF7nhnjen53t4D-w3_webrequestmethoddrop-down.png" position="flex-start" size="40" initialPath="../../quick-actions-images/web_request_method_drop-down.png" githubPath="Content/Configure/QuickActions/quick-actions-images/web_request_method_drop-down.png" showCaption="false" width="270" height="74" darkWidth="270" darkHeight="74" indent="1"} 2. Enter tenant URL along with resource location in the **URL** field. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/t4rWbaXP2yM2jW8XVbhkG_webrequesturlfield.png" position="flex-start" size="40" initialPath="../../quick-actions-images/web_request_url_field.png" githubPath="Content/Configure/QuickActions/quick-actions-images/web_request_url_field.png" showCaption="false" width="284" height="72" darkWidth="284" darkHeight="72" indent="1"} :::Paragraph{indent="1"} For example, https\://\/api/odata/businessobject/incidents('$(RecId)'). ::: 3. Enter "Authorization" for the **Header Key**, and the API key for the **Header Value**. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/_zPdc0CO1SDpxSiluJ_nb_webrequestheadersettingsexample2.png" position="flex-start" size="40" initialPath="../../quick-actions-images/web_request_header_settings_example2.png" githubPath="Content/Configure/QuickActions/quick-actions-images/web_request_header_settings_example2.png" showCaption="false" width="782" height="76" darkWidth="782" darkHeight="76" indent="1"} 4. Click **Add Header** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/EjDisTnBZw2APskWLvLMR_webrequestaddheaderrowbutton.png" alt caption size="10" width="29" height="29"} to add a second header key and value row. 5. Enter "Content-Type" for the **Header Key**, and application/json for the **Header Value**. This indicates that the request body contains JSON data. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/qiJGg1mNJSD_b2wJr-h4b_webrequestheadersettingsexample3.png" position="flex-start" size="40" initialPath="../../quick-actions-images/web_request_header_settings_example3.png" githubPath="Content/Configure/QuickActions/quick-actions-images/web_request_header_settings_example3.png" showCaption="false" width="660" height="84" darkWidth="660" darkHeight="84" indent="1"} ### Response Settings - **Ignore Certificate Errors**: Check this box to have the Web Request Quick Action ignore certificate errors (such as an expired certificate error) and continue processing the remaining steps in the Quick Action. - **Store Response Code As**: Creates and populates a variable to store the response code for use in subsequent action steps. - **Store Response Body As**: Creates and populates a variable to store the response body for in subsequent action steps. - **Store Response Headers As**: Creates and populates a variable to store the response header for in subsequent action steps. Click **Save** to commit your settings. ### Start Block Settings These settings are accessed by selecting the **Start Block**, refer to [Start Block Settings](docId:2Wq6ihUN2zxiR21eA3M7g).