---
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`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/user-terminals`
- Auth: HTTP bearer

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.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)