# Auto Provisioning Phone Information Parameters

Auto provisioning lets the phone system push configuration to phones automatically, so you do not have to set up each handset by hand. When you export or import an auto provisioning phone list, each column in the CSV (comma-separated values) file corresponds to one of the parameters below. Use this reference to prepare an import file or to interpret an exported one. Values shown in `code` format are the literal entries the file expects.

:::note
Vendor, Model, MAC Address, and Template are all required in every row. If any required value is missing or does not match an accepted entry, that row fails to import.
:::

| Parameter | Required? | Format and notes | Default |
|-----------|-----------|------------------|---------|
| Vendor | Required | The phone manufacturer. The value must match a [supported vendor](/pbx/administrator-guide/import-and-export-parameters-auto-provisioning-phone-information-parameters-permitted-value/). |- |
| Model | Required | The phone model. The value must match a [supported model](/pbx/administrator-guide/import-and-export-parameters-auto-provisioning-phone-information-parameters-permitted-value/) for the selected vendor. |- |
| MAC Address | Required | The MAC (Media Access Control) address of the phone, the unique hardware identifier printed on the device. Permitted characters are digits `0`-`9`, letters `A`-`Z` or `a`-`z`, hyphens (`-`), and colons (`:`). The entry can be up to 17 characters long and must contain a 12-character identifier, for example `FA-B5-49-1A-2B-3C`, `FA:B5:49:1A:2B:3C`, or `FAB5491A2B3C`. |- |
| Template | Required | The name of the provisioning template applied to the phone. Enter the name of a default or custom template. |- |
| RPS PIN | Optional | For Yealink phones, the RPS (Redirection and Provisioning Service) PIN a user can enter on the handset to finish RPS provisioning when it is required. Letters and numbers only, up to 31 characters. |- |
| Onsite Proxy UUID | Optional | The UUID (universally unique identifier) of the Onsite Proxy instance used for provisioning. |- |
| Hot Desking Phone | Optional | Whether the phone is configured as a hot desking phone. Enter `0` to disable or `1` to enable. An empty field defaults to `0`. | `0` |
| Authentication First-time | Optional | Whether the user must enter authentication details on the phone before the first provisioning run. Enter `0` to disable or `1` to enable. This setting applies only when Onsite Proxy UUID is empty. An empty field is filled with the default shown at right. | `1` when Hot Desking Phone is `0`; otherwise `0` |
| Assign Extension | Required when Hot Desking Phone is `0` | The extension assigned to the phone. Digits only. For IP (Internet Protocol) phones, up to 11 characters. For DECT (Digital Enhanced Cordless Telecommunications) phones, up to 1024 characters in the form `{Handset Number}:{Extension Number}`, separating multiple handsets with `&`, for example `1:1002&2:1005&3:1006`. |- |

## Finding parameter values in the console

:::tip
To look up a template name, go to **Auto Provisioning > Resource Repository > Default Templates / Custom Templates** and copy the entry from the **Template Name** column.

To look up an Onsite Proxy UUID, go to **System > Onsite Proxy** and copy the value from the **UUID** column for the instance you want.
:::

## Rules that prevent import errors

Several fields interact with **Hot Desking Phone**. Getting these combinations wrong causes the import to fail.

:::caution
- Do not set **Hot Desking Phone** to `1` for DECT phones.
- When **Hot Desking Phone** is `1`, **Authentication First-time** must be `0`.
- When **Hot Desking Phone** is `1`, leave **Assign Extension** empty.
:::