---
title: "POST /api/builder/{builder_id}/pages/"
method: POST
path: "/api/builder/{builder_id}/pages/"
tags: ["Builder pages"]
---

# POST /api/builder/{builder_id}/pages/

`POST /api/builder/{builder_id}/pages/`

Creates a new page for an application builder

## Path parameters

- `builder_id` integer, required

## Headers

- `ClientSessionId` string, uuid

## Request body

- CreatePage
  - `name` string, required
  - `path` string, required
  - `path_params` PathParam[]
    - `name` string, required — The name of the parameter.
    - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric
  - `query_params` PathParam[]
    - `name` string, required — The name of the parameter.
    - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric

## Response `200`

- Page — 👉 Mind to update the baserow.contrib.builder.api.domains.serializer.PublicPageSerializer when you update this one.
  - `id` integer, required
  - `name` string, required
  - `path` string, required
  - `path_params` PathParam[]
    - `name` string, required — The name of the parameter.
    - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric
  - `order` integer, required — Lowest first.
  - `builder_id` integer, required
  - `shared` boolean, required
  - `visibility` 'all' | 'logged-in', required — * `all` - All * `logged-in` - Logged In
  - `role_type` 'allow_all' | 'allow_all_except' | 'disallow_all_except', required — * `allow_all` - Allow All * `allow_all_except` - Allow All Except * `disallow_all_except` - Disallow All Except
  - `roles` unknown, required
  - `query_params` QueryParam[]
    - `name` string, required — The name of the parameter.
    - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric
  - `graph` unknown, required

## Other responses

- `400`
- `404`

---

[API](https://skmtc.net/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.net/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/0c490e5b0c7f/schema)