v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB

Call Forwarding

Create Forwarding Number

Adds a new forwarding number to the forwarding number list.

post/restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Request body

flipNumberinteger

Number assigned to the call flip phone number, corresponds to the shortcut dial number

phoneNumberstring

Forwarding/Call flip phone number

labelstring

Forwarding/Call flip number title

type'PhoneLine' | 'Home' | 'Mobile' | 'Work' | 'Other'

Forwarding/Call flip phone type. If specified, 'label' attribute value is ignored. The default value is 'Other'

Response

idstring

Internal identifier of a forwarding/call flip phone number

uristring uri

Canonical URI of a forwarding/call flip phone number

phoneNumberstring

Forwarding/Call flip phone number

labelstring

Forwarding/Call flip number title

featuresstring[]

Type of option this phone number is used for. Multiple values are accepted

flipNumberstring

Number assigned to the call flip phone number, corresponds to the shortcut dial number

Forwarding phone number type