---
title: "Create Stats Block"
method: POST
path: "/v3.0/boards/{boardSlug}/blocks/stats/"
tags: ["boards"]
---

# Create Stats Block

`POST /v3.0/boards/{boardSlug}/blocks/stats/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/boards/{boardSlug}/blocks/stats/`
- Auth: none declared. Required headers: `x-api-key`

## Path parameters

- `boardSlug` string, required

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- StatsBlockRequest
  - `form` string
  - `position` integer
  - `title` string, nullable
  - `location` 'left-sidebar' | 'right-sidebar' | 'header' | 'footer' | 'main' | 'non-primary'
  - `color` string, nullable: color of block
  - `config` object, nullable
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `stats_settings` object: shows list of available stats and whether they're active on the board.
  - `roles` integer[]: roles that have access to this block.

## Response `201`

- StatsBlock
  - `type` 'generic' | 'menu' | 'stats' | 'form_display' | 'form_result' | 'form_charts' | 'report' | 'kanban' | 'content' | 'ai_summary'
  - `slug` string, nullable
  - `form` string
  - `stats` object
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `position` integer
  - `title` string, nullable
  - `location` 'left-sidebar' | 'right-sidebar' | 'header' | 'footer' | 'main' | 'non-primary'
  - `color` string, nullable: color of block
  - `config` object, nullable
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `stats_settings` object: shows list of available stats and whether they're active on the board.
  - `roles` integer[]: roles that have access to this block.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)