As of Friday October 16th, access to restricted content on this site now requires you to log in with your Genesys account. If you don't have an account, you can request one at these locations: Request MyPartner Portal Account or Request My Support Account.
Jump to: navigation, search


This operation is part of the Voice API section of the Web Services API.


Sets call forwarding on the device to the specified destination.

Request URL /api/v2/me/calls/{id}
HTTP method POST
Required features api-voice


Parameter Value
operationName ForwardCallsOn
destination The number where Web Services should forward calls.



POST api/v2/me/devices/efe1ab32-53f9-43ce-b65e-5768c61f7d4a
  "operationName": "ForwardCallsOn",
  "destination": "5001"

HTTP response

  "statusCode": 0

CometD notification

  "data": {
    "messageType": "DeviceStateChangeMessage",
    "devices": [
        "id": "efe1ab32-53f9-43ce-b65e-5768c61f7d4a",
        "deviceState": "Active",
        "userState": {
          "id": "9430250E-0A1B-421F-B372-F29E69366DED",
          "displayName": "Ready",
          "state": "Ready"
        "phoneNumber": "5005",
        "e164Number": "5005",
        "telephonyNetwork": "Private",
        "doNotDisturb": "Off",
        "forwardTo": "5001",
        "voiceEnvironmentUri": "",
        "capabilities": [
  "channel": "/v2/me/devices"
This page was last edited on March 25, 2016, at 18:22.


Comment on this article:

blog comments powered by Disqus