---
title: "POST Datapoint"
method: POST
path: "/forecast/datapoint?access_token=xxxxxxx"
---

# POST Datapoint

`POST /forecast/datapoint?access_token=xxxxxxx`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/forecast/datapoint?access_token=xxxxxxx`
- Auth: API key in query parameter `access_token`

Permission level: 5

## Request body `application/x-www-form-urlencoded`

- object
  - `value` string, required: Sets the name of the Forecast/Datatype
  - `data_type_id` string, required: Adds a description for this forecast/datatype
  - `period` string, date, required: Sets the unique id of the forecast/datatype

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `company_id` integer
    - `forecast_data_type_id` integer
    - `value` integer
    - `period` string
    - `created_by` integer
    - `updated_by` unknown
    - `deleted_by` unknown
    - `created_at` string
    - `updated_at` unknown
    - `deleted_at` unknown
    - `hour` string
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/forecast/datapoint%3Faccess_token=xxxxxxx/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
