---
title: "custom request · RUAL Documentation"
description: "Creates a custom request with the given data and path"
canonical: https://docs.rual.nl/block-types/saltedge/saltedgeconnection_request
language: en
---

# custom request

This block is part of the [`saltedge`](https://docs.rual.nl/block-types/saltedge) group and was last modified in core [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

Creates a custom request with the given data and path

- flow `flow`

- connection required `saltedgeconnection` current saltedge connection

- path required `value` the API endpoint path, e.g. `customers`

- method required `value` the API endpoint method

Default `GET`

- params `object` the API endpoint params

- body `object` the API endpoint body

- flow `flow`

- connection `saltedgeconnection` current saltedge connection

- success `condition` Returns the success state of the API request

- response `object` The response the given API returned

```
{
  "data": {}
}
```

- error `value` An API error if the success out-pin if `false`

A typical wiring for [custom request](https://docs.rual.nl/block-types/saltedge/saltedgeconnection_request): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [get countries](https://docs.rual.nl/block-types/saltedge/saltedgeconnection_get_countries) feeds the `connection` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `path` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `method` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the custom request block: typical wiring for custom request.](https://docs.rual.nl/canvas-examples/saltedgeconnection_request.png)

### Version history

Introduced in [`v13.0.6`](https://docs.rual.nl/core-versions/130006).