---
title: "Create a specialty line"
method: POST
path: "/v2/partition/{partitionId}/account/{accountId}/specialty-line"
tags: ["Specialty Line"]
---

# Create a specialty line

`POST /v2/partition/{partitionId}/account/{accountId}/specialty-line`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/specialty-line`
- Auth: API key in header `X-AUTH-TOKEN`

Use to create a new specialty line on an account

## Path parameters

- `accountId` string, required
- `partitionId` string, required

## Request body

- SpecialtyLineRequestDto
  - `callerId` string, required: The phone number displayed on the phone of the person being called.
  - `callingPlanIds` string[], required: Calling plans allow you to control where your customers are allowed to call and what, if any, the cost should be for those calls. Each of your plans can be set up with a number of included minutes or a per-minute rate, depending on how you want to charge for services. The calling plans created at the partition level can be assigned to individual accounts and users based on their needs or the bundle they purchased.
  - `deviceType` string: The generic device type that matches the customer's device configuration.
  - `e911CallbackNumber` string, required: The phone number that will be transmitted to 911.
  - `macAddress` string: The device's MAC address.
  - `name` string, required: A name for the specialty line, such as Elevator C or another descriptive term.
  - `portNumber` integer: The physical port number the line is provisioned on (1–9).
  - `sipPassword` string: A unique plain-text password is automatically generated and displayed here. Use this one or enter your own, using at least 6 characters.
  - `sipUsername` string: A unique 14-character SIP username is automatically generated and displayed here. Use this one or enter your own, between 8-36 characters long.

## Response `201`

Line created successfully

- SpecialtyLineResponseDto
  - `accountId` string, required
  - `callerId` string: The phone number displayed on the phone of the person being called.
  - `callingPlanIds` string[], required: Calling plans allow you to control where your customers are allowed to call and what, if any, the cost should be for those calls. Each of your plans can be set up with a number of included minutes or a per-minute rate, depending on how you want to charge for services. The calling plans created at the partition level can be assigned to individual accounts and users based on their needs or the bundle they purchased.
  - `deviceId` string
  - `deviceType` string: The generic device type that matches the customer's device configuration.
  - `e911CallbackNumber` string: The phone number that will be transmitted to 911.
  - `id` string, required: The ID is immutable and cannot be changed.
  - `linkedPhoneNumbers` string[]
  - `macAddress` string: The device's MAC address.
  - `name` string, required: A name for the specialty line, such as Elevator C or another descriptive term.
  - `partitionId` string, required
  - `portNumber` integer: The physical port number the line is provisioned on (1–9).
  - `sipPassword` string: A unique plain-text password is automatically generated and displayed here. Use this one or enter your own, using at least 6 characters.
  - `sipUsername` string: A unique 14-character SIP username is automatically generated and displayed here. Use this one or enter your own, between 8-36 characters long.

## Other responses

- `400`: Invalid Specialty Line object supplied
- `403`: Partition or account not found
- `409`: Device already exists: MAC and Port combination must be unique

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/cb514a0728ed?raw)