# HTTP Request (API)

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FB1CpdmrEisGPc4FdF0V6%2Fimage.png?alt=media&#x26;token=347cbe65-3674-4af8-96c4-29b5d848d131" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2F8R7qRtTVkvpKILKhGMMa%2Fimage.png?alt=media&#x26;token=8e0167d5-367b-4dd0-b166-5809ce2b474e" alt=""><figcaption></figcaption></figure>

## Description

**What it does:** This node enhances your workflows by allowing you to connect to external APIs (Application Programming Interfaces). Think of APIs as bridges connecting different software systems.

**When to use it?** If your workflow needs to connect with other web services, like retrieving info from a website, the HTTP Request node helps integrate it seamlessly.

## Component settings

| Parameter Name | Description                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Method         | <p>Choose the method</p><p><br>Options: </p><ul><li>GET</li><li>POST </li><li>PUTCH</li><li>PATCH</li><li>DELETE</li></ul> |
| URL            | Input the URL (Endpoint Link)                                                                                              |
| Header         | <p>Input the header of API, including:</p><ul><li>Key : Value</li></ul><p></p>                                             |
| Parameters     | <p>Input the Parameter of API, including:</p><ul><li>Key : Value</li></ul>                                                 |
| Payload (Body) | <p></p><p>Input the Payload of API, including:</p><ul><li>Key : Value</li></ul>                                            |

## Advanced configurations

**Failure handling strategy** lets you decide what happens if your HTTP Request runs into a problem.&#x20;

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2Fispkh5hNw9HuRfb8IRdC%2Fimage.png?alt=media&#x26;token=1ca8b7fe-b270-4f54-a5a8-fe0159b84f30" alt=""><figcaption></figcaption></figure>

You’ve got a few options:

* **Stop flow** – If something goes wrong, the workflow stops right here.
* **Skip** – If this request fails, just move on and keep the workflow going.
* **Retry** – Give it another shot! You can set how many times to retry and how long to wait between each try.
  * Max retry attempts:
    * Min: 1
    * Max: 3
  * Delay between retries (seconds):&#x20;
    * Min: 1
    * Max: 5

<mark style="color:red;">If all retries fail, the flow will stop at this HTTP Request node.</mark>

## Example

**Input**

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FjkG2Jbd5xBj1rkwwN1EB%2Fimage.png?alt=media&#x26;token=39e85a57-5883-469b-aba4-9906364743df" alt=""><figcaption></figcaption></figure>

**Output**

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FJFfNbNYwsyu9Gg5GKmLq%2Fimage.png?alt=media&#x26;token=df3d48e4-7e25-4ba5-a774-28499d8d475e" alt=""><figcaption></figcaption></figure>
