> For the complete documentation index, see [llms.txt](https://docs.gpmautomate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gpmautomate.com/automate-en/action-guides/http/http-request.md).

# HTTP Request

### Action of sending a network request (HTTP Request)

HTTP Request is an advanced action used to send network requests directly from a script to a server system, third-party API, or websites without having to open a browser interface for manual interaction. This action helps optimize data processing speed by several times.

#### Explanation of configuration parameters:

* URL: The address path of the resource or API on the server that needs to be interacted with (For example: `[https://api.telegram.org/bot.../sendMessage](https://api.telegram.org/bot.../sendMessage)`).
* Method: The communication method to define the action performed:
  * `GET`: Retrieve (read) data from the server.
  * `POST`: Send new data to the server (commonly used for logging in, creating posts, sending messages).
  * `PUT` / `PATCH`: Update existing data on the server.
  * `DELETE`: Delete resources on the server.
* Header: Additional information sent along with the request for the server to identify the browser or authenticate access.
  * *For example*: `Content-Type: application/json` (the format of the data being sent), or `Authorization: Bearer <secret_token>` (the authentication configuration code).
* Data (Body / Payload): The actual data sent along with the request (only applicable when selecting methods like `POST`, `PUT`, `PATCH`).
* Timeout: The maximum time (measured in seconds depending on the interface settings) that the action will wait for a response from the server. If this time is exceeded without a response from the server, the action will automatically disconnect and report an error (or throw an exception) to avoid the script hanging indefinitely due to network lag or the opposing server being down.
* Use profile's proxy: An option that allows using the Proxy assigned to that Profile to send the request. If not checked, the system will use your computer's local IP address to send it.

#### Formatting the Data (Body) configuration according to each type of content

Depending on the requirements of the API documentation from the server, the Data section must be filled out according to different formatting standards:

**Example 1: With body format `application/json`**

This is the most common format today when working with modern APIs. The body must be filled out according to the structure of curly braces `{}` and the data fields must be enclosed in double quotes following the JSON standard.

<figure><img src="/files/UqEQnQegKXUDPtMsdg5V" alt=""><figcaption></figcaption></figure>

**Example 2: With body format `application/x-www-form-urlencoded`**

This is a traditional data string format often encountered in old login forms or some payment gateways. The property pairs are concatenated into a continuous text string.

<figure><img src="/files/BcVx38BAcKs4G5Mfkjbj" alt=""><figcaption></figcaption></figure>

**Example 3: With body format `multipart/form-data`**

This is a special format that must be used when you need to upload files (such as images, videos, document files) or send complex mixed forms from your computer to the server.

<figure><img src="/files/QhqwLWynZTnall8XOsp1" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gpmautomate.com/automate-en/action-guides/http/http-request.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.