Call Queues - Adding and Removing Users

RingCentral Call Queues are a common way to assign responsibility for answering calls to an extension to multiple users.

Adding and removing user extensions from a queue is done using the account/~/department/bulk-assign endpoint which can be used to assign and remove extensions from multiple call queue departments in one API call.

The API endpoints are as follows:

• account/~/department/bulk-assign

Ruby SDK Request

The following is an example using the Ruby SDK with the built-in Faraday client.

res = client.http.post do |req|
  req.url 'account/~/department/bulk-assign'
  req.body = {
    items: [
      {
        departmentId: 11112222,
        addedExtensionIds: [22221111,22222222],
        removedExtensionIds: [22223333,22224444]
      },
      {
        departmentId: 11113333,
        addedExtensionIds: [22221111,22222222]
      }
    ]
  }
end

HTTP Request

POST /restapi/v1.0/account/~/department/bulk-assign
Accept: application/json
Content-Type: application/json
Accept-Language: en-US

{
  "items": [
    {
      "departmentId": "11112222",   
      "addedExtensionIds": [
        "22221111", "22222222"
      ],
      "removedExtensionIds": [
        "22223333", "22224444"
      ]
    }, 
    {
      "departmentId": "11113333",   
      "addedExtensionIds": [
        "22221111", "22222222"
      ]
    }
  ] 
}

HTTP Response

HTTP/1.1 200 OK