---
title: "Create multiple POIs"
method: POST
path: "/api/poi/batch"
tags: ["POI"]
---

# Create multiple POIs

`POST /api/poi/batch`

## Request

- Base URL: `https://api.payware.eu`
- URL: `https://api.payware.eu/api/poi/batch`
- Auth: HTTP bearer

Creates multiple Points of Interaction in a single atomic call. Maximum 50 POIs per request.

## Request body

- POIBatchCreateRequest
  - `shopCode` string, required
  - `callbackUrl` string
  - `ttlSeconds` integer
  - `pois` POIBatchCreateItem[], required
    - `name` string
    - `callbackUrl` string
    - `ttlSeconds` integer

## Response `201`

POIs created successfully

## Other responses

- `400`: Invalid request (batch too large, empty, invalid TTL or callback URL)
- `401`: Unauthenticated - missing, malformed or expired credentials
- `403`: Forbidden - the caller is authenticated but not permitted (plan or capability gate, KYC state, or tenant scope)
- `404`: Shop not found
- `429`: Too many requests - the caller exceeded its per-partner rate limit. Carries errorCode ERR_RATE_LIMIT_EXCEEDED and a Retry-After header, in seconds. The request was not processed, so the identical request is safe to retry once the window has passed.

---

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