---
title: "Assign terminals"
method: POST
path: "/assignTerminals"
tags: ["General"]
deprecated: true
---

# Assign terminals

`POST /assignTerminals`

> **Deprecated.**

Assigns one or more payment terminals to a merchant account or a store. You can also use this endpoint to reassign terminals between merchant accounts or stores, and to unassign a terminal and return it to company inventory.

>From January 1, 2025 POS Terminal Management API is deprecated and support stops on April 1, 2025. To automate the management of your terminal fleet, use our [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).

## Request body

- AssignTerminalsRequest
  - `companyAccount` string, required — Your company account. To return terminals to the company inventory, specify only this parameter and the `terminals`.
  - `merchantAccount` string — Name of the merchant account. Specify this parameter to assign terminals to this merchant account or to a store under this merchant account.
  - `merchantInventory` boolean — Boolean that indicates if you are assigning the terminals to the merchant inventory. Do not use when assigning terminals to a store. Required when assigning the terminal to a merchant account. - Set this to **true** to assign the terminals to the merchant inventory. This also means that the terminals cannot be boarded. - Set this to **false** to assign the terminals to the merchant account as in-store terminals. This makes the terminals ready to be boarded and to process payments through the specified merchant account.
  - `store` string — The store code of the store that you want to assign the terminals to.
  - `terminals` string[], required — Array containing a list of terminal IDs that you want to assign or reassign to the merchant account or store, or that you want to return to the company inventory. For example, `["V400m-324689776","P400Plus-329127412"]`.

## Response `200`

OK - the request has succeeded.

- AssignTerminalsResponse
  - `results` object, required — Array that returns a list of the terminals, and for each terminal the result of assigning it to an account or store. The results can be: - `Done`: The terminal has been assigned. - `AssignmentScheduled`: The terminal will be assigned asynschronously. - `RemoveConfigScheduled`: The terminal was previously assigned and boarded. Wait for the terminal to synchronize with the Adyen platform. For more information, refer to [Reassigning boarded terminals](https://docs.adyen.com/point-of-sale/managing-terminals/assign-terminals#reassign-boarded-terminals). - `Error`: There was an error when assigning the terminal.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2025-01-06** (v1) `9c22824cacf1` — 1 info
  - endpoint deprecated
- **2023-06-22** (v1) `6c089164bff1` — 1 info
  - the endpoint scheme security `BasicAuth` was added to the API
- **2023-03-07** (v1) `a1d5aadcf2a3` — 7 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - …3 more

[Change history](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated/changes/assignTerminals/post.md)

---

[API](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated.md) · [All operations](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/pos-terminal-management-api-deprecated/revisions/079660320468/schema)