---
title: "Create a Web POS device"
method: POST
path: "/v1/webpos/"
tags: ["Web POS"]
---

# Create a Web POS device

`POST /v1/webpos/`

Create a Web POS device. Web POS devices represent a station/browser instance/device, for example 'Reception', 'Back Office', 'Joe iPad', etc.

**Required scopes: `business/webpos:read`, `business/webpos:write`**

## Request body

- CreateWebPOSDeviceRequest
  - `name` string, required — A friendly device name.

## Response `201`

Successful Response

- WebPOSDevice
  - `id` string, uuid, required — The unique ID for the Web POS device.
  - `name` string, required — The friendly POS device name.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

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