---
description: performs a REST service call
---

# REST Service Executor

<img src="https://processmix.com/wp-content/uploads/2023/01/Property-1Connector_REST.png" alt="" data-size="line"> The REST Service Executor node is a versatile utility designed to execute REST calls against a specified connector. It facilitates interaction with the server by sending HTTP request and retrieving response. This function is typically used in applications that require external data integration for data retrieval.

***

## Properties

### Common

<mark style="color:purple;">**Name**</mark> - refers to the unique identifier or label assigned to a node within a flow.

<table><thead><tr><th width="139">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td>input Text</td><td><ul><li>must consist of letters (A-Z or a-z), digits (0-9), underscores (_), or dollar signs ($). However, a class name cannot start with a digit and dollar sign ($)</li><li>Unique per flow</li><li>Mandatory</li><li>Min length: 1</li><li>Max length: 255</li><li><a href="../../../appendix/reserved-words">Reserved words</a></li></ul></td></tr></tbody></table>

<mark style="color:purple;">**Description**</mark> - provides a textual description or additional information about a  node within a flow. Unlike the name property, which serves as a unique identifier or label for the node, the description property offers supplementary details that help to clarify the purpose, functionality, or behavior of the node.

<table><thead><tr><th width="144">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td>Input Text</td><td><ul><li>Max length: 5000</li></ul></td></tr></tbody></table>

### Specific

<mark style="color:purple;">**Service**</mark> - to be executed. You can select any service from the project or its [dependencies](../../../dependencies).

<table><thead><tr><th width="211">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td><a href="../../../../connectors/rest-connector#services">REST connector service reference</a></td><td><ul><li>Mandatory</li></ul></td></tr></tbody></table>

<mark style="color:purple;">**Request**</mark> - payload. This appears only if the HTTP method of the selected service supports a payload (e.g., the HTTP GET method does not support it).

<table><thead><tr><th width="213">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td>Any structure <a href="../../expressions">Expression</a></td><td><ul><li>Mandatory</li></ul></td></tr></tbody></table>

<mark style="color:purple;">**Path parameters**</mark> -  [parameters](../../../../connectors/rest-connector#path-parameters) defined for the selected service.

<table><thead><tr><th width="213">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td>String, Integer, Float or Boolean <a href="../../expressions">Expression</a></td><td><ul><li>Mandatory</li></ul></td></tr></tbody></table>

<mark style="color:purple;">**Request parameters**</mark> -  [parameters](../../../../connectors/rest-connector#request-parameters) defined for the selected service.

<table><thead><tr><th width="213">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td>String, Integer, Float or Boolean <a href="../../expressions">Expression</a></td><td><ul><li>Mandatory</li></ul></td></tr></tbody></table>

### Optional

<mark style="color:purple;">**Headers**</mark> -  an array of HTTP headers to be sent with the payload.

<table><thead><tr><th width="213">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td><a href="../../../../structures/pdk.core#array">Array</a>&#x3C;<a href="../../../../structures/pdk.net.http#header">Header</a>> <a href="../../expressions">Expression</a></td><td><ul><li>Optional</li></ul></td></tr></tbody></table>

<mark style="color:purple;">**Cookies**</mark> -  an array of HTTP cookies to be sent with the payload.

<table><thead><tr><th width="213">Type</th><th>Restrictions</th></tr></thead><tbody><tr><td><a href="../../../../structures/pdk.core#array">Array</a>&#x3C;<a href="../../../../structures/pdk.net.http#cookie">Cookie</a>> <a href="../../expressions">Expression</a></td><td><ul><li>Optional</li></ul></td></tr></tbody></table>

***

## Result

A new [node variable](../../variables/node-variables) with type [pdk.net.http.Response](../../../../structures/pdk.net.http#response) has been added to the flow's scope.

***

## Connections

| Type | Min count | Max count |
| ---- | --------- | --------- |
| in   | 1         | \*        |
| out  | 1         | 1         |

