---
title: "Create PageGroup"
method: POST
path: "/pagegroups"
tags: ["PageGroups", "pagegroups"]
---

# Create PageGroup

`POST /pagegroups`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/pagegroups`
- Auth: API key in header `token`

Add a new PageGroup to an account.

## Request body

- object
  - `label` string, required: Name/Label for PageGroup
  - `soundfile` string: SoundFile ID
  - `max_page_time` integer: Max page time in seconds
  - `tone_length` integer: Tone length in seconds
  - `devices` string[], required

## Response `201`

Created

- object
  - `pagegroup` PageGroup
    - `id` string: PageGroup ID.
    - `label` string: Name/Label for PageGroup.
    - `max_page_time` integer: Max page time in seconds
    - `tone_length` integer: Tone length in seconds
    - `soundfile` string: SoundFile ID
    - `devices` string[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)