---
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: 968
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/http/requests/post/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---
* Flux 0.173.0+
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/)
| result_url |
| --- |
| result_url |
| https://goolnk.com/BnXAE6 |
| statusCode | body | headers | duration |
| --- | --- | --- | --- |
| statusCode | body | headers | duration |
| 200 | | | |