Web Request

Send an HTTP request to a URL. Use this action to perform a variety of requests, including GET, POST, PUT, SOAP 1.1, SOAP 1.2, and customized request methods. This request is also used to call ASMX web services.

This action supports Anonymous and Basic authentication types.

Note: This is an external action and may execute on servers running outside your data center Centralized locations used to house servers used by Nintex for remote storage, processing, or distribution of data. Nintex has a number of regional data centers available for Nintex for Office 365. For information about Nintex data centers and where your data center is located, contact your Nintex account or territory manager. region. Before implementing, consider performance and regional concerns where digital boundaries are an issue. For more information, see In-tenant and external actions.

Action settings

Do one of the following to open the Action configuration window:

  • Double-click the action.
  • Click on the action and then click Configure.

See Action configuration window for more information.

Field Description
URL

Specify the URL to which to send the request.

Method

Specify the method to be used for the request, including any additional headers required for the method; add headers as needed.

  • GET: Select the GET method.
  • POST: Select the POST method.
    • Content type: Specify the content type to be used for the request.

  • PUT: Select the PUT method.
    • Content type: Specify the content type to be used for the request.

  • SOAP 1.1: Select the SOAP 1.1 method.
    • Soap action: Specify the SOAP action to be used for the request.

  • SOAP 1.2: Select the SOAP 1.2 method.
  • Other: Specify a custom method.
    • Custom method: Specify the custom method to be used for the request.

Add header: Click to add a header to be sent with the request. Multiple headers can be specified.

  • Header name (key): Specify the header name.

  • Header value: Specify the header value.

  • Delete (): Deletes the indicated header.
Body

Specify the data to be included in the body of the request. This option is not available for requests using the GET method.

  • Existing SharePoint content: Specify the URL to the file within the current site.

  • Content: Specify the content to be added into the body.

  • Current item (option available for workflows associated with document libraries): Upload the current file that the workflow is running on.
Username

Specify a username if using Basic authentication for the request.

Note: If no credentials are specified, then Anonymous authentication is used.

Password

Specify the password for the above username.

Store response content in

Specify a text variable to store the contents of the response to this request.

Store http status code in

Specify a integer variable to store the numeric http response code of this request.

Store response headers in

Specify a collection or dictionary variable to store each response header for this request. Each header will be represented by a single item in the collection, and will be formatted as header name=header value.

Store response cookies in

Specify a collection or dictionary variable to store each response cookie for this request. Each cookie will be represented by a single item in the collection, and will be formatted as cookie name=cookie value.

For more information about how to use Lookups in configuration fields, see Lookups in action configuration fields.