---
title: "Create a heatmap"
method: POST
path: "/sdk/v1/heatmaps/create"
tags: ["Heatmaps"]
---

# Create a heatmap

`POST /sdk/v1/heatmaps/create`

Creates a new heatmap for this application. Bounds are defined as two opposing world-space points (`pointA`, `pointB`); `resolutionFactor` (1-255) sets sample density. Optional `description` and `metadata` are stored alongside the definition.

## Headers

- `isstudio` union
  - boolean
  - 'true' | 'false'
- `project-id` integer

## Request body

- object
  - `name` string, required
  - `bounds` object, required
    - `pointA` object, required
      - `x` number, required
      - `y` number, required
      - `z` number, required
    - `pointB` object, required
      - `x` number, required
      - `y` number, required
      - `z` number, required
  - `resolutionFactor` number, required
  - `description` string
  - `metadata` object

## Response `201`

Default Response

- object

---

[API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) · [All operations](https://skmtc.dev/gamebeast/apis/gamebeast-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gamebeast/gamebeast-api/revisions/801fbad9d8d0/schema)