# Create or update a payment page

> POST /stores/{id}/pages endpoint of the Proteside API: parameters, request body, responses and code samples.

URL: https://docs.proteside.com/en/docs/api/reference/pages/upsertPage

## Method and route

`POST /stores/{id}/pages`

Keyed by `store_id + url_pattern` (`*` wildcard supported).

## Parameters

- `id` (path, `string`, required)
- `org_id` (query, `string`): Partners only (`orgs:manage`): act on this child organization. May also be sent as `org_id` in JSON bodies.
- `Idempotency-Key` (header, `string`): Replays the original response for 24 h

## Request body

- `url_pattern` (`string`), required: Path starting with '/', '*' wildcard allowed
- `payment_methods` (`PaymentMethod[]`)
- `mode` (`"monitor" | "block"`)

## Responses

- `201`: Page
- `400`: Validation error

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
