RingCentral icon

RingCentral

Interact with RingCentral API - SMS, Voice, Fax, Meetings, and more

Call Queue → Update

AI-generated

Summary

Update a RingCentral call queue with the specified JSON payload.

Inputs

  • authMode — Choose to use saved credentials or pass an access token dynamically. Defaults to predefined credentials saved in n8n credentials store. Select 'Dynamic Access Token (Multi-Tenant)' to provide a token and server environment at runtime.
  • accessToken — The valid OAuth 2.0 Access Token. Required when authMode is set to 'dynamic'. Treated as a secret input (password masking enabled in UI).
  • serverUrl — The RingCentral API environment. Shown only when authMode is 'dynamic'. Defaults to production (https://platform.ringcentral.com); use sandbox (https://platform.devtest.ringcentral.com) for testing.
  • queueId (required) — Identifies the call queue to update. Loaded from the RingCentral API via getCallQueues for dropdown selection; alternatively specify an ID using an n8n expression.
  • updatePayload (required) — JSON payload sent to the RingCentral API when updating the call queue. Defaults to a payload naming the queue 'Main Queue'. Authors typically provide a full object conforming to RingCentral's call queue update schema.

Output shape

The RingCentral API response object representing the updated call queue, including properties such as id, name, extension, and member configuration.

The operation performs a PUT/POST to the /restcallqueues/{queueId} endpoint. Authentication is handled per the selected authMode; dynamic mode requires a valid access token and correct server URL. The node retries on 401 (token refresh), 429 (rate limit with exponential backoff), 403, 404, and 5xx errors as defined in GenericFunctions.js.

Examples

Example 1: Update a call queue using saved credentials

Set authMode to 'credentials', leave accessToken and serverUrl empty, select the target queue from the queueId dropdown, and provide a JSON payload in updatePayload (e.g., '{}' to change the name).

Example 2: Update a call queue using a dynamic token

Set authMode to 'dynamic', provide a valid accessToken, set serverUrl to the desired environment, specify queueId (or use an expression), and supply the update payload.

Links

Discussion