Create Phone

Create a new phone object.

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

External Documentation

To learn more, visit the Duo documentation.

​

Basic Parameters

Parameter	Description
Name	A free-form label to describe the phone.
Phone Number	The phone number. E.164 format recommended (i.e. [phone]). 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

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