The POST action sends an HTTP POST request to a REST service.
Use the POST action to submit data to an external system, create new resources, upload files, or trigger operations that require information to be sent in the request body. Unlike GET and HEAD requests, POST requests can include a payload containing data that the service processes.
A POST request sends data to a specified endpoint. The request may include URL parameters, request headers, and a request body. The REST service processes the request and returns a response that can include: response data, HTTP status code, and response headers.
The returned values can be mapped to process variables and used elsewhere in the process.
The input parameters of the action are:
| Parameter | Type | Required | Description |
|---|---|---|---|
| restUrl | String | Required | The URL of the REST service endpoint to call, including the protocol and resource path. For example: http://hyland.com |
| restUrlParams | JSON | Optional | A JSON object containing query parameter names and values to append to the request URL.
Use this property to pass values such as filters, search criteria, or
identifiers. For example:{
"status": "active",
"page": "1",
"pageSize": "50"
}
|
| restUrlEncoded | Boolean | Optional | Specifies whether the URL should be URL-encoded before the request is sent. Enable this option when the URL contains special characters that require encoding. |
| requestHeaders | JSON | Optional |
A JSON object containing request header names and values. Headers can be used to provide authentication information, specify content types, or include additional request metadata. Values can be fixed values or process variables. The available request headers are defined in the API documentation for the endpoint that REST is calling. |
| requestPayload | JSON | Optional |
The body of the request. You can choose from the following options:
The downstream application validates Content-Type strictly and rejects requests with generic or mismatched types. The pre-selected option depends on the requestHeaders value. |
| circuitBreaker | Boolean | Optional | Enables or disables circuit breaker protection for the request. When enabled, the connector can prevent repeated calls to an unavailable service and help improve process resilience. |
| timeout | Integer | Optional |
The timeout period to wait for the service in milliseconds. The default timeout is 30 000. |
The output parameters from POST are:
| Parameter | Type | Required | Description |
|---|---|---|---|
| restResult | JSON | Optional | The response data returned by the REST service. The format and contents depend on the endpoint being called and can be mapped to process variables for use elsewhere in the process. |
| restStatus | Integer | Optional | The HTTP status code returned by the REST service. Use this value to determine whether the request completed successfully and to support conditional process routing or error handling. |
| responseHeaders | JSON | Optional | The HTTP response headers returned by the REST service. Response headers contain metadata about the response, such as content type, caching information, security policies, and resource details. |