> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Phone

Create a new phone object.

**Note**: This action requires the `Grant resource - Write` API permission.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Duo documentation](https://duo.com/docs/adminapi#create-phone).

## Basic Parameters

| Parameter | Description |
| - | - |
| Name | A free-form label to describe the phone. |
| Phone Number | The phone number. E.164 format recommended (i.e. `+17345551212`). If no leading plus sign is provided then it is assumed to be a United States number and an implicit `+1` country code is prepended. Dashes and spaces are ignored. **Note**: A phone with a smartphone platform but no number is a tablet. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Extension | The phone extension. |
| Platform | The phone's platform. Note that `Windows Phone` is accepted as a synonym for `Windows Phone 7`. This includes devices running `Windows Phone 8`. If a smartphone's exact platform is unknown but it will have Duo Mobile installed, use `Generic Smartphone` and generate an activation code. When the phone is activated its platform will be detected automatically. |
| Post Delay | The time (in seconds) to wait after the extension is dialed and before speaking the prompt. |
| Pre Delay | The time (in seconds) to wait after the number picks up and before dialing the extension. |
| Type | The phone's type. |

## Example Output

```json theme={"dark"}
{
	"response": {
		"activated": false,
		"capabilities": [
			"sms"
		],
		"encrypted": "Unknown",
		"extension": "",
		"fingerprint": "Unknown",
		"last_seen": "",
		"model": "Unknown",
		"name": "test-phone",
		"number": "+12142144286",
		"phone_id": "DPERLUZ8CIO49STDMKDP",
		"platform": "Google Android",
		"screenlock": "Unknown",
		"sms_passcodes_sent": false,
		"tampered": "Unknown",
		"type": "Mobile",
		"users": []
	},
	"stat": "OK"
}
```