---
title: requests.post() function
description: 'requests.post() makes a http POST request. This identical to calling request.do(method: "POST", ...).'
url: https://docs.influxdata.com/flux/v0/stdlib/http/requests/post/
estimated_tokens: 2662
product: Flux
version: v0
---
# requests.post() function
- Flux 0.173.0+
- View InfluxDB support
`requests.post()` makes a http POST request. This identical to calling `request.do(method: "POST", ...)`.
##### Function type signature
```js
(
url: string,
?body: bytes,
?config: {A with timeout: duration, insecureSkipVerify: bool},
?headers: [string:string],
?params: [string:[string]],
) => {statusCode: int, headers: [string:string], duration: duration, body: bytes}
```
For more information, see [Function type signatures](/flux/v0/function-type-signatures/).
## Parameters
### url
(Required) URL to request. This should not include any query parameters.
### params
Set of key value pairs to add to the URL as query parameters. Query parameters will be URL encoded. All values for a key will be appended to the query.
### headers
Set of key values pairs to include on the request.
### body
Data to send with the request.
### config
Set of options to control how the request should be performed.
## Examples
- [Make a POST request with a JSON body and decode JSON response](#make-a-post-request-with-a-json-body-and-decode-json-response)
- [Make a POST request with query parameters](#make-a-post-request-with-query-parameters)
### Make a POST request with a JSON body and decode JSON response
```js
import "http/requests"
import ejson "experimental/json"
import "json"
import "array"
response =
requests.post(
url: "https://goolnk.com/api/v1/shorten",
body: json.encode(v: {url: "http://www.influxdata.com"}),
headers: ["Content-Type": "application/json"],
)
data = ejson.parse(data: response.body)
array.from(rows: [data])
```
[](#view-example-output)
View example output
#### Output data
| result_url |
| --- |
| https://goolnk.com/BnXAE6 |
### Make a POST request with query parameters
```js
import "http/requests"
response =
requests.post(url: "http://example.com", params: ["start": ["100"], "interval": ["1h", "1d"]])
// Full URL: http://example.com?start=100&interval=1h&interval=1d
requests.peek(response: response)
```
[](#view-example-output)
View example output
#### Output data
| statusCode | body | headers | duration |
| --- | --- | --- | --- |
| 200 | | | |
Example Domain
```
```
# Example Domain
This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.
[More information...](https://www.iana.org/domains/example)
| \[ Accept-Ranges: bytes, Cache-Control: max-age=604800, Content-Length: 1256, Content-Type: text/html; charset=UTF-8, Date: Thu, 06 Apr 2023 15:02:21 GMT, Etag: "3147526947", Expires: Thu, 13 Apr 2023 15:02:21 GMT, Last-Modified: Thu, 17 Oct 2019 07:18:26 GMT, Server: EOS (vny/0453) \] | 91346421 |
[http](/flux/v0/tags/http/) [inputs](/flux/v0/tags/inputs/)