RingCentral API

Access RingCentral call logs, recordings, SMS/MMS, voicemail, fax, presence status, and call analytics.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: RingCentral OAuth client ID

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true
}

Run with real data

{
  "demoMode": false,
  "task": "get_call_logs",
  "clientId": "YOUR_API_KEY_HERE",
  "clientSecret": "YOUR_API_KEY_HERE",
  "accessToken": "YOUR_API_KEY_HERE",
  "refreshToken": "YOUR_API_KEY_HERE",
  "accountId": "~",
  "extensionId": "~",
  "direction": "all",
  "callType": "all",
  "includeRecordings": false,
  "limit": 100
}

---

Input Parameters

Parameter	Type	Default	Required	Description
task	string	"get_call_logs"	Yes*	The operation to perform
clientId	string	-	Yes*	RingCentral OAuth client ID
clientSecret	string	-	Yes*	RingCentral OAuth client secret
accessToken	string	-	Yes*	RingCentral OAuth access token
refreshToken	string	-	Yes*	RingCentral OAuth refresh token
accountId	string	"~"	No	RingCentral account ID (use ~ for current)
extensionId	string	"~"	No	Extension ID (use ~ for current user)
startDate	string	-	No	Start date for data retrieval (ISO 8601)
endDate	string	-	No	End date for data retrieval (ISO 8601)
direction	string	"all"	No	Filter by call direction
callType	string	"all"	No	Filter by call type
callId	string	-	No	Specific call/recording ID
phoneNumber	string	-	No	Filter by phone number
toNumber	string	-	No	Recipient phone number (for send_sms)
fromNumber	string	-	No	Sender phone number (for send_sms)
messageText	string	-	No	SMS message content
includeRecordings	boolean	false	No	Include recording URLs in call logs
limit	integer	100	No	Maximum number of results
webhookUrl	string	-	No	URL to receive results via webhook
demoMode	boolean	true	No	Run with sample data (no API calls)

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
API Request	Each RingCentral API request completed	$0.01

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal