---
title: "Add user terminal to service line"
method: POST
path: "/public/v2/service-lines/{serviceLineNumber}/user-terminals"
tags: ["Service Lines"]
---

# Add user terminal to service line

`POST /public/v2/service-lines/{serviceLineNumber}/user-terminals`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/service-lines/{serviceLineNumber}/user-terminals`
- Auth: HTTP bearer

Required permission: Service plan, Edit.<br/>User terminal must already be on the account. See POST /v2/user-terminals to add user terminal to account.

## Path parameters

- `serviceLineNumber` string, required

## Request body

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

## Response `200`

User terminals added to service line

- 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 the user terminal to the service line

---

[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)