---
title: "Add user terminal to account"
method: POST
path: "/public/v2/user-terminals"
tags: ["User Terminals"]
---

# Add user terminal to account

`POST /public/v2/user-terminals`

Required permission: Device management, Edit.<br/>This will add the user terminal to the account, but won't start service. User terminals must be present on the account before adding to a service line.

## Request body

- DeviceIdRequest
  - `deviceId` string, required — User terminal Id, kit serial number, or dish serial number. Ex: 12345678-12345678-12345678

## Response `200`

User terminal added to account

- ServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean

## Other responses

- `400` — Bad request. Invalid or missing parameter
- `401` — Unauthorized
- `403` — Missing required permission for this endpoint or resource
- `422` — Failed to add user terminal to the account

---

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