---
title: "Create your page (claim a username)"
method: POST
path: "/api/v1/claim"
---

# Create your page (claim a username)

`POST /api/v1/claim`

## Request

- Base URL: `https://posy.page`
- URL: `https://posy.page/api/v1/claim`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://posy.page/api/auth/oauth2/authorize`, token URL `https://posy.page/api/auth/oauth2/token`, scopes: `page:write`)

## Request body

- object
  - `username` string, required
  - `style` string
  - `layout` string
  - `preset` string
  - `empty` boolean

## Response `201`

Created

## Other responses

- `409`: You already have a page

---

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