Skip to main content

HTTP Request

Description

Make an HTTP call. Enables performing HTTP requests to a specified web application.

Configuration

You can configure this Activity at design time by clicking the Configure button, which will open a configuration dialog.

Configuration Dialog

Properties

Input

  • Accept Format - The Format to receive the web API response. Supported formats are:   - Any   - Json (Default)   - XML   - YAML

  • Authentication Type – The authentication type to be used for the request. The following authentication types are supported:   - Basic Authentication   - Windows Authentication   - OAuth 1.0   - OAuth 2.0

  • Host – Address for the target point. Custom URL segments must be placed between braces "" and provide values in URL segments.

  • Inherit Authorization - If set to true, inherits the authorization details from the parent  Authorization Scope Activity.

  • Method – The request method to be used when calling the API. The following methods are currently supported:

    MethodDescription
    GETRetrieves data from the server.
    POSTSubmits data to be processed. Used to create new resources or submit form data. (Default)
    PUTUpdates existing data on the server.
    DELETEDeletes data on the server.
    HEADRetrieves metadata about the resource without the response body. Useful for checking resource availability.
    OPTIONSRetrieves supported HTTP methods for the server, often used for CORS preflight requests.
    PATCHPartially updates a resource on the server.

Misc

  • DisplayName – Add a display name to your Activity.
  • Private – By default, Activity will log the values of your properties inside your workflow. If private is selected, then it stops logging.

Optional

  • Attachments – Attach files to the request.
  • body – Specify the request body content.
  • Body Format – Select the body format. Available options include:  

Body Format

  • Continue On Error – Specify if the automation should continue on error. Defaults to False.  
note

If the Activity is in a Try-Catch block and Continue On Error is set to True, errors will be ignored.

  • Cookies - Include custom cookies in the request.
  • Headers – Add custom headers.
  • Parameters – Add custom text parameters.
  • Query Params - Include custom query parameters.
  • Save Response To - Specify a file path to save the response.
  • Timeout - Set the request timeout in seconds. Default is 10 seconds.
  • URL Segments - Add URL segments in {} format, e.g., https://jsonplaceholder.typicode.com/posts/{id}.

Output

  • Response - The full response from the HTTP call.
  • Response Cookies – Cookies returned by the HTTP call.
  • Response Headers – Headers returned in the response.
  • Result – The response result.
  • Status Code – The HTTP status code.
note

If the Status Code is 0, the server did not respond, possibly due to connectivity issues.

Example

Download Example