docs-v2/content/influxdb/cloud/write-data/developer-tools/api.md

title	weight	description	menu
Write data with the InfluxDB API	206	Use the `/write` endpoint of the InfluxDB API to write data to InfluxDB.	influxdb_cloud name parent name parent InfluxDB API Developer tools Write data Javascript

Write data to InfluxDB using an HTTP request to the InfluxDB API /write endpoint. Use the POST request method and include the following in your request:

Requirement	Include by
Organization	Use the org query parameter in your request URL.
Bucket	Use the bucket query parameter in your request URL.
Precision	Use the precision query parameter in your request URL.
Authentication token	Use the Authorization: Token header.
Line protocol	Pass as plain text in your request body.

Example

The URL in the examples depends on your InfluxDB Cloud region.

{{< code-tabs-wrapper >}} {{% code-tabs %}} Curl Node.js {{% /code-tabs %}} {{% code-tab-content %}}

curl -XPOST "https://cloud2.influxdata.com/api/v2/write?org=YOUR_ORG&bucket=YOUR_BUCKET&precision=s" \
  --header "Authorization: Token YOURAUTHTOKEN" \
  --data-raw "
mem,host=host1 used_percent=23.43234543 1556896326
mem,host=host2 used_percent=26.81522361 1556896326
mem,host=host1 used_percent=22.52984738 1556896336
mem,host=host2 used_percent=27.18294630 1556896336
"

{{% /code-tab-content %}} {{% code-tab-content %}}

{{< api/nodejs/write >}}

{{% /code-tab-content %}} {{< /code-tabs-wrapper >}}

{{% note %}} To compress data when writing to InfluxDB, set the Content-Encoding header to gzip. Compression reduces network bandwidth, but increases server-side load.

curl -XPOST "https://cloud2.influxdata.com/api/v2/write?org=YOUR_ORG&bucket=YOUR_BUCKET&precision=s" \
  --header "Authorization: Token YOURAUTHTOKEN" \
  --header "Content-Encoding: gzip" \
  --data-raw "
mem,host=host1 used_percent=23.43234543 1556896326
mem,host=host2 used_percent=26.81522361 1556896326
mem,host=host1 used_percent=22.52984738 1556896336
mem,host=host2 used_percent=27.18294630 1556896336
"

{{% /note %}}

For information about InfluxDB API response codes, see InfluxDB API Write documentation.