RingCentral

This page contains the setup guide and reference information for the RingCentral source

Prerequisites

Auth Token (which acts as bearer token), account id and extension id are mandate for this connector to work, Account token could be received by following (Bearer ref - https://developers.ringcentral.com/api-reference/authentication), and account_id and extension id could be seen at response to basic api call to an endpoint with ~ operator. Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)

Setup guide

Step 1: Set up RingCentral connection

• Get your bearer token by following auth section (ref - https://developers.ringcentral.com/api-reference/authentication)
• Setup params (All params are required)
• Available params
  • auth_token: Recieved by following https://developers.ringcentral.com/api-reference/authentication
  • account_id: Could be seen at response to basic api call to an endpoint with ~ operator.
    \ Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)
  • extension_id: Could be seen at response to basic api call to an endpoint with ~ operator.
    \ Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)

Step 2: Set up the RingCentral connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the RingCentral connector and select RingCentral from the Source type dropdown.
4. Enter your auth_token, account_id, extension_id.
5. Click Set up source.

For Airbyte OSS:

1. Navigate to the Airbyte Open Source dashboard.
2. Set the name for your source.
3. Enter your auth_token, account_id, extension_id.
4. Click Set up source.

Supported sync modes

The RingCentral source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	No
Replicate Incremental Deletes	No
SSL connection	Yes
Namespaces	No

Supported Streams

• user_business_hours
• company_business_hours
• callblock_settings
• blocked_allowed_phonenumbers
• forwarding_numbers
• company_call_handling_rules
• user_call_records
• user_active_calls
• call_monitoring_groups
• call_queues
• call_record_settings
• greetings
• ivr_prompts
• fax_cover

API method example

GET https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours

Performance considerations

RingCentral API reference has v1 at present. The connector as default uses v1.

Changelog

<details> <summary>Expand to review</summary>

Version	Date	Pull Request	Subject
0.2.22	2025-05-24	60537	Update dependencies
0.2.21	2025-05-10	60159	Update dependencies
0.2.20	2025-05-04	59640	Update dependencies
0.2.19	2025-04-27	58396	Update dependencies
0.2.18	2025-04-12	57968	Update dependencies
0.2.17	2025-04-05	57359	Update dependencies
0.2.16	2025-03-29	56772	Update dependencies
0.2.15	2025-03-22	56231	Update dependencies
0.2.14	2025-03-08	55050	Update dependencies
0.2.13	2025-02-23	54554	Update dependencies
0.2.12	2025-02-15	53968	Update dependencies
0.2.11	2025-02-08	53492	Update dependencies
0.2.10	2025-02-01	52969	Update dependencies
0.2.9	2025-01-25	52517	Update dependencies
0.2.8	2025-01-18	51882	Update dependencies
0.2.7	2025-01-11	51353	Update dependencies
0.2.6	2024-12-28	50716	Update dependencies
0.2.5	2024-12-21	50298	Update dependencies
0.2.4	2024-12-14	49665	Update dependencies
0.2.3	2024-12-12	49367	Update dependencies
0.2.2	2024-12-11	49048	Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.2.1	2024-10-29	47611	Update dependencies
0.2.0	2024-08-20	44448	Refactor connector to manifest-only format
0.1.15	2024-08-17	44247	Update dependencies
0.1.14	2024-08-12	43830	Update dependencies
0.1.13	2024-08-10	43662	Update dependencies
0.1.12	2024-08-03	43148	Update dependencies
0.1.11	2024-07-27	42591	Update dependencies
0.1.10	2024-07-20	42294	Update dependencies
0.1.9	2024-07-13	41891	Update dependencies
0.1.8	2024-07-10	41433	Update dependencies
0.1.7	2024-07-10	41328	Update dependencies
0.1.6	2024-07-06	40973	Update dependencies
0.1.5	2024-06-25	40480	Update dependencies
0.1.4	2024-06-22	40054	Update dependencies
0.1.3	2024-06-06	39111	Make compatible with builder
0.1.2	2024-06-04	38937	[autopull] Upgrade base image to v1.2.1
0.1.1	2024-05-20	38382	[autopull] base image + poetry + up_to_date
0.1.0	2023-05-10	Init	Initial commit

</details>