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

# Create Menu Block

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

## Request

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

## Path parameters

- `boardSlug` string, required

## Headers

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

## Request body

- MenuBlockRequest
  - `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
  - `roles` integer[]: roles that have access to this block.

## Response `201`

- MenuBlock
  - `type` 'generic' | 'menu' | 'stats' | 'form_display' | 'form_result' | 'form_charts' | 'report' | 'kanban' | 'content' | 'ai_summary'
  - `slug` string, nullable
  - `form` string
  - `items` MenuItem[]
    - `sub_items` object
    - `icon` string
    - `roles` string[]
    - `teams` string[]
    - `blocks` object
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `slug` string, nullable
    - `title` string, required
    - `position` integer
    - `page_title` string, nullable: page title for the page represented by this item.
    - `type` 'block' | 'link' | 'embed' | 'group', required
    - `link` string, uri, nullable: the link to which the menu item is set.
    - `description` string, nullable: an optional description on the menu item.
    - `content` object: enter your content here. It should be in json format.
    - `cover_slug` string, nullable: the cover's slug.
    - `cover_url` string, nullable: the cover's url.
    - `config` object, nullable
    - `color` string, nullable: color of item
    - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
    - `access_settings` object, nullable
    - `copy_info` object, nullable
    - `suspicious` boolean: Shows wether the board contains any suspicious menu items.
  - `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
  - `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)