# POST

### Overview

The **HTTP POST Component** sends HTTP POST requests to external services. It supports both raw body and form-data submissions, making it suitable for various API interactions.

### Usage

#### Input Parameters

| Parameter          | Type                | Description                                                                                                                                    |
| ------------------ | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | `string`            | Fully qualified URI of the target resource (required).                                                                                         |
| `headers`          | `object`            | JSON object containing request headers.                                                                                                        |
| `bodyType`         | `string`            | Specifies the format of the request body. Options: `raw`, `form-data`.                                                                         |
| `body`             | `string` / `object` | Request body content for `raw` mode.                                                                                                           |
| `bodyFormData`     | `object`            | Key-value pairs for `form-data` submissions.                                                                                                   |
| `bodyBase64Encode` | `boolean`           | If enabled, encodes request body in Base64 format.                                                                                             |
| `responseEncoding` | `string`            | Encoding format for the response (default: `utf8`). Supported values: `ascii`, `utf8`, `utf16le`, `base64`, `latin1`, `binary`, `hex`, `null`. |

#### Output Parameters

| Parameter    | Description                                  |
| ------------ | -------------------------------------------- |
| `body`       | The response body from the external service. |
| `headers`    | The response headers.                        |
| `request`    | Request metadata.                            |
| `statusCode` | The HTTP status code of the response.        |

### Notes

* Supports both `raw` and `form-data` body types.
* `form-data` mode allows file uploads along with other input types.
* Proper headers must be set for `application/json` or `multipart/form-data` depending on the request type.
