Call forwarding and flipping

Last updated: 2024-02-28Contributors
Edit this page

Every RingCentral extension may have a list of phone numbers to which calls can be forwarded. A "forwarding number" is any external (non-RingCentral) or internal phone number/extension used for redirecting incoming calls. They are also used when connecting calls via the RingOut API. Each user is able to specify ten forwarding numbers under the following 3 predefined labels:

  • 'Home'
  • 'Mobile'
  • 'Office'

In addition, users can create up to seven custom labels (by changing the 'Other' label).

Flipping calls

The Call Flip option transfers a call to another device while the call is active. RingCentral phone numbers with the provisioned phone devices and the external forwarding numbers specified by the user are available for the call flip option. They are automatically entered into the Call Flip list. They can then be prioritized and ordered within that list. Flipping a call to a specific phone is available by dialing a shortcut dial number, which is returned by the server in the flipNumber field.

The API allows retrieving forwarding and call flip numbers for a certain extension by the URI:

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

Below is a sample response.

{
  "uri" : "https:.../restapi/v1.0/account/400249137008/extension/400249137008/forwarding-number?page=1&perPage=100",
  "records" : [ {
    "phoneNumber" : "+17605550044",
    "label" : "John Smith Desk Phone",
    "features" : [ "CallFlip" ],
    "flipNumber" : "1"
  }, {
    "phoneNumber" : "+18885558944",
    "label" : "Work",
    "features" : [ "CallForwarding", "CallFlip" ],
    "flipNumber" : "2"
  }, {
    "phoneNumber" : "+14805550003",
    "label" : "Jane Smith Softphone",
    "features" : [ "CallFlip" ],
    "flipNumber" : "3"
  }, {
    "phoneNumber" : "+12075550027",
    "label" : "Other",
    "features" : [ "CallForwarding", "CallFlip" ],
    "flipNumber" : "4"
  } ],
  "paging" : {
    "page" : 1,
    "totalPages" : 1,
    "perPage" : 100,
    "totalElements" : 4,
    "pageStart" : 0,
    "pageEnd" : 3
  },
  "navigation" : {
    "firstPage" : {
      "uri" : "https:.../restapi/v1.0/account/400249137008/extension/400249137008/forwarding-number?page=1&perPage=100"
    },
    "lastPage" : {
      "uri" : "https:.../restapi/v1.0/account/400249137008/extension/400249137008/forwarding-number?page=1&perPage=100"
    }
  }
}

Rate this page: