---
title: "Create terminal"
method: POST
path: "/terminals"
tags: ["Point of Sale"]
---

# Create terminal

`POST /terminals`

Add a new CTAP to an existing terminal group for a MultiSafepay account.

## Request body

- object
  - `provider` 'CTAP' — The type of terminal.
  - `group_id` integer — The unique identifier of the terminal group to which the terminal will be added.
  - `name` string — The name of the terminal.

## Response `200`

Request successful

- object
  - `success` boolean — Whether the request was successful.
  - `data` object — The created terminal object.
    - `id` TerminalId — unresolved $ref
    - `provider` 'CTAP' — The type of terminal linked to the account.
    - `name` string — The display name of the terminal.
    - `created` string, date-time — The timestamp for when the terminal record was created.
    - `last_updated` string, date-time — The timestamp for when the terminal record was last updated.
    - `manufacturer_id` string — The brand name of the manufacturer.
    - `serial_number` string — The serial number of the terminal.
    - `active` boolean — Indicates whether the terminal is currently active. - `true`: The terminal is active and operational. - `false`: The terminal is inactive and not operational.
    - `group_id` integer — The identifier of the group the terminal belongs to.
    - `country` string — The country associated to the MultiSafepay account. **Format:** [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements).

## Other responses

- `404` — Error

---

[API](https://skmtc.dev/multisafepay/apis/multisafepay-banking-order-api.md) · [All operations](https://skmtc.dev/multisafepay/apis/multisafepay-banking-order-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multisafepay/multisafepay-banking-order-api/revisions/ce9612e4a307/schema)