docs-v2/content/flux/v0.x/stdlib/http/post.md

title	description	aliases	menu	weight	introduced
http.post() function	The `http.post()` function submits an HTTP POST request to the specified URL with headers and data. The HTTP status code is returned.	/influxdb/v2.0/reference/flux/functions/http/post/ /influxdb/v2.0/reference/flux/stdlib/http/post/ /influxdb/cloud/reference/flux/stdlib/http/post/	flux_0_x_ref name parent http.post http	202	0.40.0

The http.post() function submits an HTTP POST request to the specified URL with headers and data and returns the HTTP status code.

import "http"

http.post(
    url: "http://localhost:8086/",
    headers: {x:"a", y:"b", z:"c"},
    data: bytes(v: "body"),
)

Parameters

url

The URL to POST to.

headers

Headers to include with the POST request.

{{% note %}}

Header keys with special characters

Wrap header keys that contain special characters in double quotes ("").

{"key-1": "value 1", "key#2": "value 2" }

{{% /note %}}

data

The data body to include with the POST request.

Examples

Send the last reported status to a URL

import "json"
import "http"

lastReported = from(bucket: "example-bucket")
    |> range(start: -1m)
    |> filter(fn: (r) => r._measurement == "statuses")
    |> last()
    |> findColumn(fn: (key) => true, column: "_level")

http.post(
    url: "http://myawsomeurl.com/api/notify",
    headers: {
        Authorization: "Bearer mySuPerSecRetTokEn",
        "Content-type": "application/json"
    },
    data: json.encode(v: lastReported[0]),
)