RingCentralInstall

Summary

Retrieve a list of messages from RingCentral filtered by parameters such as message type, direction, read status, and date range.

Inputs

• authMode — Choose between saved n8n credentials or dynamic access token.
• accessToken — The OAuth 2.0 access token when using dynamic authentication.
• serverUrl — The RingCentral environment endpoint (Production or Sandbox) when using dynamic authentication.
• returnAll — Whether to fetch all matching messages or limit the total returned.
• limit — Maximum number of messages to return when returnAll is set to false (1 to 1000).
• filters — Additional filtering conditions including messageType (SMS, Fax, Text, VoiceMail), direction (Inbound, Outbound), readStatus (Read, Unread), dateFrom, dateTo, and phoneNumber.

Output shape

a list of items

Returns an array of items, each containing details of a RingCentral message record matching the provided criteria.

Examples

Example 1: Retrieve all unread inbound SMS messages

Set Return All to true, and in Filters set Direction to Inbound and Read Status to Unread.

Example 2: Get the latest 50 outbound messages sent to a specific number

Set Return All to false, Limit to 50, and in Filters set Direction to Outbound and Phone Number to the destination number.

Links

• n8n community nodes installation guide