# Phones

# Overview

The **Phones** page defines provisioned phones, device models, MAC addresses, line assignments, and provisioning secrets. Open it from **Configuration > Provisioning > Phones**.

The page works against the tenant currently selected in the top bar. The screenshots and demo rows were captured in the **Canistracci OIL** tenant.

The phone record also includes a **Description** field for internal notes. The value is informational only and is not used when generating provisioning files, registering phones, or routing calls.

The phone record also includes a **Description** field for internal notes. The value is informational only and is not used when generating provisioning files, registering phones, or routing calls.

The phone record also includes a **Description** field for internal notes. The value is informational only and is not used when generating provisioning files, registering phones, or routing calls.

<figure id="bkmrk-phones-list-page-in-">![Phones list page in the Canistracci OIL tenant.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/17Bphones-list.png)<figcaption>Phones list page in the Canistracci OIL tenant.</figcaption></figure>## Working with objects

<table id="bkmrk-taskhow-to-do-it-add"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Add</td><td>Select the New phone action, complete the form, and select Save.</td></tr><tr><td>Edit</td><td>Open the phone from the list by selecting its name, number, or row action. Change the form and select Save.</td></tr><tr><td>Delete</td><td>Select the row checkbox and use Delete Selected, or open the phone and select Delete, then confirm.</td></tr></tbody></table>

## Page functions

<table id="bkmrk-actiondescription-ne"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>New Phone</td><td>Opens the creation form for a new phone.</td></tr><tr><td>Resync config</td><td>Sends the selected device operation to the selected phones.</td></tr><tr><td>Reboot</td><td>Sends the selected device operation to the selected phones.</td></tr><tr><td>Delete Selected</td><td>Deletes the selected rows after confirmation.</td></tr></tbody></table>

## List columns

<table id="bkmrk-columndescription-na"><thead><tr><th>Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Display name used in lists and references.</td></tr><tr><td>Phone Model</td><td>Object setting shown by the form.</td></tr><tr><td>Extensions</td><td>Target or routing selection used when the object sends a call or message onward.</td></tr><tr><td>MAC plain</td><td>Object setting shown by the form.</td></tr><tr><td>Autoprovisioning URL</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Demo records

The tenant contains 1 documentation demo record for this page: Docs Demo Phone 1.

## Deleting records

Before deleting a phone, check references from call flows, destinations, schedules, reports, or provisioning objects. MiRTA PBX asks for confirmation before the delete is submitted.

# Create and Edit Phones

Use this page when creating a new phone or editing an existing phone from **Configuration &gt; Phones**.

The form screenshots below are separated by block where the application exposes separate sections. Complete the required values, review routing or destination references, and save the record.

## Add and edit form

<figure id="bkmrk-phones-add%2Fedit-form">![Phones add/edit form with the Description field for internal notes.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/DI5phone-form-description.png)<figcaption>Phones add/edit form with the Description field for internal notes.</figcaption></figure>## Main fields

<table id="bkmrk-fielddescription-nam"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Name:</td><td>Display name used in lists and references.</td></tr><tr><td>Description:</td><td>Free-form notes about the phone, such as physical location, assigned user, install details, or operational comments. This value is informational only and is not used for provisioning generation or call processing.</td></tr><tr><td>Virtual phone provisioning</td><td>Object setting shown by the form.</td></tr><tr><td>Model:</td><td>Object setting shown by the form.</td></tr><tr><td>MAC Address:</td><td>Object setting shown by the form.</td></tr><tr><td>Secret:</td><td>Credential or PIN value. Treat it as sensitive.</td></tr><tr><td>Accept data from phone</td><td>Object setting shown by the form.</td></tr><tr><td>Optional file name:</td><td>Display name used in lists and references.</td></tr><tr><td>HTTP/S Username:</td><td>Display name used in lists and references.</td></tr><tr><td>HTTP/S Password:</td><td>Credential or PIN value. Treat it as sensitive.</td></tr><tr><td>Line 0:</td><td>Object setting shown by the form.</td></tr><tr><td>Line 1:</td><td>Object setting shown by the form.</td></tr><tr><td>Line 2:</td><td>Object setting shown by the form.</td></tr><tr><td>Line 3:</td><td>Object setting shown by the form.</td></tr><tr><td>Line 4:</td><td>Object setting shown by the form.</td></tr><tr><td>Line 5:</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Saving and deleting

<table id="bkmrk-taskhow-to-do-it-cre"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Create</td><td>Select the new action from the Phones list, fill the required fields, and select Save.</td></tr><tr><td>Edit</td><td>Open the existing phone, update the needed fields, and select Save.</td></tr><tr><td>Delete</td><td>Before deleting a phone, check call-flow, destination, schedule, report, provisioning, or integration references. Use the row delete action or the form delete action when available, then confirm.</td></tr></tbody></table>