RingCentral Office API Quick Reference

Last updated: 2020-09-28 Contributors Byrne Reese
Edit this page

Welcome to a quick reference of all RingCentral Office API endpoints, provided as a convenience for those who need a convenient way to find a specific endpoint. For a complete reference, check out RingCentral's complete and interactive Office API Reference.

Expand/collapse all

API Info

Method Description
Get API Versions

Returns current API version(s) and server info.

GET /restapi

Get Version Info

Returns current API version info by apiVersion.

GET /restapi/{apiVersion}

Automatic Location Updates

Method Description

Returns the list of users with their status of Automatic Location Updates feature.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/users

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
department string false Department name to filter the users. The value range is 0-64; not case-sensitive. If not specified then the parameter is ignored. Multiple values are supported
featureEnabled boolean false Filters entries by their status of Automatic Location Updates feature
orderBy string name false Comma-separated list of fields to order results prefixed by plus sign '+' (ascending order) or minus sign '-' (descending order). Supported values: 'name', 'modelName', 'siteName', 'featureEnabled'
page integer 1 false Indicates the page number to retrieve. Only positive number values are supported
perPage integer false Indicates the page size (number of items). The values supported: `Max` or numeric value. If not specified, 100 records are returned per one page
searchString string false Filters entries containing the specified substring in user name, extension or department. The characters range is 0-64; not case-sensitive. If empty then the filter is ignored
siteId string false Internal identifier of a site. To filter users of Main Site (Company) `main-site` must be specified. Supported only If Multi-Site feature is enabled for the account. Multiple values are supported
type string false Extension type. Multiple values are supported

API Throttling Group

Medium help_outline

Enable Automatic Location Updates for Users

Enables or disables Automatic Location Updates feature for multiple account users.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/users/bulk-assign

Returns account wireless points configured and used for Automatic Location Updates feature.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
orderBy string false Comma-separated list of fields to order results prefixed by '+' sign (ascending order) or '-' sign (descending order). The default sorting is by `name`
page integer 1 false Indicates the page number to retrieve. Only positive number values are supported
perPage integer false Indicates the page size (number of items). The values supported: `Max` or numeric value. If not specified, 100 records are returned per one page
searchString string false Filters entries by the specified substring (search by chassis ID, switch name or address) The characters range is 0-64 (if empty the filter is ignored)
siteId string false Internal identifier of a site. To filter Main Site (Company) 'main-site' must be specified. Supported only If multi-site feature is enabled for the account

API Throttling Group

Medium help_outline

Create Wireless Point

Creates a new wireless point in network configuration with the emergency address assigned.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points

Returns the specified wireless access point of a corporate map with the emergency address assigned.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points/{pointId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
pointId string True

API Throttling Group

Medium help_outline

Updates the specified wireless access point of a corporate map by ID.

PUT /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points/{pointId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
pointId string True

API Throttling Group

Heavy help_outline

Deletes wireless point(s) of a corporate map by ID(s).

DELETE /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points/{pointId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
pointId array True

API Throttling Group

Heavy help_outline

Get Network Map

Returns corporate networks map with emergency addresses assigned to the current account.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/networks

Create Network

Creates a new network in corporate ethernet map for assignment of emergency addresses to network access points.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/networks

Returns the specified network with emergency addresses assigned to the current account.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/networks/{networkId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
networkId string True

API Throttling Group

Medium help_outline

Updates network in corporate ethernet map for assignment of emergency addresses to network access points.

PUT /restapi/v1.0/account/{accountId}/emergency-address-auto-update/networks/{networkId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
networkId string True

API Throttling Group

Heavy help_outline

Deletes network(s) in corporate ethernet map for Automatic Location Updates feature.

DELETE /restapi/v1.0/account/{accountId}/emergency-address-auto-update/networks/{networkId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
networkId array True

API Throttling Group

Heavy help_outline

Returns the list of common devices with their status of Automatic Location Updates feature.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/devices

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
compatibleOnly boolean false Filters devices which support HELD protocol
featureEnabled boolean false Filters entries by their status of Automatic Location Updates feature
model string false Internal identifier of a device model for filtering. Multiple values are supported
orderBy string name false Comma-separated list of fields to order results prefixed by plus sign '+' (ascending order) or minus sign '-' (descending order). Supported values: 'name', 'modelName', 'siteName', 'featureEnabled'
page integer 1 false Indicates the page number to retrieve. Only positive number values are supported
perPage integer false Indicates the page size (number of items). The values supported: `Max` or numeric value. If not specified, 100 records are returned per one page
searchString string false Filters entries which have device name or model name containing the mentioned substring. The value should be split by spaces; the range is 0 - 64 characters, not case-sensitive. If empty the filter is ignored
siteId string false Internal identifier of a site. To filter devices of Main Site (Company) `main-site` must be specified. Supported only If Multi-Site feature is enabled for the account

API Throttling Group

Medium help_outline

Enable Automatic Location Updates for Devices

Enables or disables Automatic Location Updates feature for the specified common phones.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/devices/bulk-assign

Returns corporate map of configured network switches with the assigned emergency addresses for the logged-in account.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
orderBy string false Comma-separated list of fields to order results prefixed by '+' sign (ascending order) or '-' sign (descending order). The default sorting is by `name`
page integer 1 false Indicates the page number to retrieve. Only positive number values are supported
perPage integer false Indicates the page size (number of items). The values supported: `Max` or numeric value. If not specified, 100 records are returned per one page
searchString string false Filters entries by the specified substring (search by chassis ID, switch name or address) The characters range is 0-64 (if empty the filter is ignored)
siteId string false Internal identifier of a site. To filter Main Site (Company) main-site must be specified. Supported only If multi-site feature is enabled for the account

API Throttling Group

Heavy help_outline

Create Switch

Creates a new switch in corporate map based on chassis ID and used for Automatic Locations Update feature.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches

Returns the specified switch with the assigned emergency address.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
switchId string True

API Throttling Group

Medium help_outline

Updates switch. Partial update is not supported, all switch parameters should be specified. If null value is received or parameter is missing, its value is removed.

PUT /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
switchId string True

API Throttling Group

Heavy help_outline

Deletes wireless switch(es) in network configuration for Automatic Location Updates feature.

DELETE /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
switchId array True

API Throttling Group

Heavy help_outline

Create Multiple Switches

Creates multiple switches in corporate map. The maximum number of switches per request is 10 000; limitation for account is 10 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches-bulk-create

Update Multiple Switches

Updates multiple switches in corporate map. The maximum number of switches per request is 10 000; limitation for account is 10 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches-bulk-update

Create Multiple Wireless Points

Creates multiple wireless points in corporate map. The maximum number of wireless points per request is 10 000; limitation for account is 70 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points-bulk-create

Update Multiple Wireless Points

Updates wireless points in corporate map. The maximum number of wireless points per request is 10 000; limitation for account is 70 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points-bulk-update

Validate Multiple Wireless Points

Validates wireless points before creation or update. The maximum number of wireless points per request is 10 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/wireless-points-bulk-validate

Validate Multiple Switches

Validates switches before creation or update. The maximum number of switches per request is 10 000.

POST /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches-bulk-validate

Returns results of the task created within the frame of Automatic Location Updates feature. Currently four task types are supported: 'Wireless Points Bulk Create', 'Wireless Points Bulk Update', 'Switches Bulk Create', 'Switches Bulk Update'.

GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/tasks/{taskId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
taskId string True

API Throttling Group

Light help_outline

Returns emergency response locations of the current account.

GET /restapi/v1.0/account/{accountId}/emergency-locations

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
addressStatus string false
domesticCountryId string false
orderBy string address false Comma-separated list of fields to order results prefixed by plus sign '+' (ascending order) or minus sign '-' (descending order). Supported values: 'address'
page integer 1 false Indicates the page number to retrieve. Only positive number values are supported
perPage integer false Indicates the page size (number of items). The values supported: `Max` or numeric value. If not specified, 100 records are returned per one page
searchString string false Filters entries containing the specified substring in address and name fields. The characters range is 0-64; not case-sensitive. If empty then the filter is ignored
siteId string false Internal identifier of a site for filtering. To filter by Main Site (Company) `main-site` value should be specified
usageStatus string false

API Throttling Group

Light help_outline

Add Emergency Location

POST /restapi/v1.0/account/{accountId}/emergency-locations

Returns emergency response location by ID.

GET /restapi/v1.0/account/{accountId}/emergency-locations/{locationId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
locationId string True Internal identifier of the emergency location

API Throttling Group

Light help_outline

Updates the specified emergency response location.

PUT /restapi/v1.0/account/{accountId}/emergency-locations/{locationId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
locationId string True Internal identifier of the emergency location

API Throttling Group

Heavy help_outline

Deletes the specified emergency response location.

DELETE /restapi/v1.0/account/{accountId}/emergency-locations/{locationId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
locationId string True Internal identifier of emergency location
newLocationId string false Internal identifier of a location that should be used instead of a deleted one
validateOnly boolean false Flag indicating that validation of emergency location(s) is required before deletion

API Throttling Group

Heavy help_outline

Returns a list of emergency response locations available for the current user extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Business Hours

Method Description

Returns the user business hours schedule. Business hours (and After hours - all the remaining time) schedules are commonly used for setting call handling rules - business-hours-rule and after-hours-rule correspondingly. Please note: If the user business hours are set to 'Custom hours' then a particular schedule is returned; however if set to '24 hours/7 days a week' the schedule will be empty.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/business-hours

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates the user business hours schedule.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/business-hours

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Get Company Business Hours

Returns the company business hours schedule. Business hours (and After hours - all the remaining time) schedules are commonly used for setting call handling rules - business-hours-rule and after-hours-rule correspondingly.

GET /restapi/v1.0/account/{accountId}/business-hours

Update Company Business Hours

Updates the company business hours schedule.

PUT /restapi/v1.0/account/{accountId}/business-hours

Calendar Events

Method Description

Returns all calendar events created by the current user.

GET /restapi/v1.0/glip/events

Request Parameters

Name Type Default Required Description
pageToken string false Token of a page to be returned
recordCount integer 30 false Number of groups to be fetched by one request. The maximum value is 250, by default - 30.

API Throttling Group

Medium help_outline

Create Event

Creates a new calendar event.

POST /restapi/v1.0/glip/events

Get Event

Returns the specified calendar event(s) by ID(s).

GET /restapi/v1.0/glip/events/{eventId}

Update Event

Updates the specified calendar event.

PUT /restapi/v1.0/glip/events/{eventId}

Delete Event

Deletes the specified calendar event.

DELETE /restapi/v1.0/glip/events/{eventId}

Get Group Events

Returns a list of calendar events available for the current user within the specified group. Users can only see their personal tasks and public tasks.

GET /restapi/v1.0/glip/groups/{groupId}/events

Create Event by Group ID

Creates a new calendar event within the specified group.

POST /restapi/v1.0/glip/groups/{groupId}/events

Call Blocking

Method Description

Returns the current caller blocking settings of a user.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking

Request Parameters

Name Type Default Required Description
accountId string True
extensionId string True

API Throttling Group

Light help_outline

Updates the current caller blocking settings of a user.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking

Request Parameters

Name Type Default Required Description
accountId string True
extensionId string True

API Throttling Group

Light help_outline

Returns the lists of blocked and allowed phone numbers.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers

Request Parameters

Name Type Default Required Description
accountId string True
extensionId string True
page integer false
perPage integer false
status string false

API Throttling Group

Light help_outline

Updates either blocked or allowed phone number list with a new phone number.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers

Request Parameters

Name Type Default Required Description
accountId string True
extensionId string True

API Throttling Group

Medium help_outline

Returns blocked or allowed phone number(s) by their ID(s). Batch request is supported.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}

Request Parameters

Name Type Default Required Description
accountId string True
blockedNumberId string True
extensionId string True

API Throttling Group

Light help_outline

Updates blocked or allowed phone number(s) by their ID(s). Batch request is supported.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}

Request Parameters

Name Type Default Required Description
accountId string True
blockedNumberId string True
extensionId string True

API Throttling Group

Medium help_outline

Deletes blocked or allowed phone number(s) by their ID(s). Batch request is supported.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}

Request Parameters

Name Type Default Required Description
accountId string True
blockedNumberId string True
extensionId string True

API Throttling Group

Medium help_outline

Call Control

Method Description
Make CallOut

Creates a new outbound call out session. Currently this method is supported for Softphone/Hardphone only, since device IDs for WebRTC/Mobile apps cannot be obtained.

POST /restapi/v1.0/account/{accountId}/telephony/call-out

Start Conference Call Session

Initiates a conference call session.

POST /restapi/v1.0/account/{accountId}/telephony/conference

Returns the status of a call session by ID.

GET /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
telephonySessionId string True Internal identifier of a call session
timeout string false The time frame of awaiting for a status change before sending the resulting one in response
timestamp string false The date and time of a call session latest change

API Throttling Group

Light help_outline

Drops a call session.

DELETE /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Puts the party to stand-alone mode and starts to play Hold Music according to configuration & state to peers. There is a known limitation for Hold API - hold via REST API doesn't work with hold placed via RingCentral apps or HardPhone. It means that if you muted participant via Call Control API and RingCentral Desktop app, then you need to unhold both endpoints to remove Hold Music and bring media back.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/hold

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Brings a party back into a call and stops to play Hold Music. There is a known limitation for Hold API - hold via REST API doesn't work with hold placed via RingCentral apps or HardPhone. It means that if you muted participant via Call Control API and RingCentral Desktop app, then you need to unhold both endpoints to remove Hold Music and bring media back.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/unhold

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Rejects an inbound call in a "Setup" or "Proceeding" state

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/reject

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Ignores a call to a call queue agent in Setup or Proceeding state.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/ignore

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Transfers an answered call to the specified call party. Applicable for a call session in "Answered" or "Hold" state.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/transfer

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Allows the user to connect multiple call session participants over a conference call bridge. The current active call session ID and party ID of the user within this session should be specified in path; the bridged call session ID and party ID of the user within that session should be specified in request body. Thus the user connects participants of two sessions into one conference call using his/her own party IDs from both sessions.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/bridge

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Answers a call on a certain device by passing the corresponding device ID in request body. Supported for call forwarding, call transfer, call flip and call queues.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/answer

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Picks up a call parked to the specified park location.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/pickup

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Forwards a non-answered incoming call to the specified call party. Applicable for a call session in "Setup" or "Proceeding" state.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/forward

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Replies with text/pattern without picking up a call.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/reply

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Performs call flip procedure by holding opposite party and calling to the specified target

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/flip

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Parks a call to a virtual location from where it can further be retrieved by any user from any phone of the system. The call session and call party identifiers should be specified in path. Currently the users can park only their own incoming calls. Up to 50 calls can be parked simultaneously. Park location starts with asterisk (*) and ranges 801-899.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/park

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Adds a new party to the call session by bringing-in an established SIP call connection. The maximum number of parties to bring-in is 10; only 1 call party can be added per request. Currently the method is supported for sessions of 'Conference' origin only.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/bring-in

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Returns a call party status by ID.

GET /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Removes a party from a call session by ID. A party can be deleted only if supervised or parked. It is possible to delete only one conference participant per request.

DELETE /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Modifies a call party by ID. There is a known limitation for Mute scenario - mute via REST API doesn't work with mute placed via RingCentral apps or HardPhone. It means that if you muted participant via Call Control API and Ringcentral Desktop app you need to unmute both endpoints to bring the media back.

PATCH /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Starts a new call recording for the party

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/recordings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Pause/resume recording

PATCH /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/recordings/{recordingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
brandId string ~ True Identifies a brand of a logged in user or a brand of a sign-up session
partyId string True Internal identifier of a call party
recordingId string True Internal identifier of a recording
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Allows to monitor a call session in 'Listen' mode. Input parameters should contain internal identifiers of a monitored user and a supervisor's device. Call session should be specified in path. Please note that this method supports single channel audio flow, which means that audio of both call participants is mixed and delivered to the supervisor in single audio channel. Currently this method is supported for Softphone/Hardphone only, since device IDs for WebRTC/Mobile apps cannot be obtained.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/supervise

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Allows to monitor a call party in 'Listen' mode. Input parameters are extension number of a monitored user and internal identifier of a supervisor's device. Call session and party identifiers should be specified in path. Please note that for this method dual channel audio flow is supported, which means that you need to make one more request for monitoring the second participant of a call. And as a result of each monitoring request the client recieves SIP invite with the following header p-rc-api-monitoring-ids containing IDs of the monitored party and session. The flow is supported for calls with no more than 2 participants. Currently this method is supported for Softphone/Hardphone only, since device IDs for WebRTC/Mobile apps cannot be obtained.

POST /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}/parties/{partyId}/supervise

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
partyId string True Internal identifier of a call party
telephonySessionId string True Internal identifier of a call session

API Throttling Group

Light help_outline

Call Forwarding

Method Description

Returns the list of extension phone numbers used for call forwarding and call flip. The returned list contains all the extension phone numbers used for call forwarding and call flip.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted.
perPage integer 100 false Indicates the page size (number of items).

API Throttling Group

Light help_outline

Adds a new forwarding number to the forwarding number list.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns a specific forwarding number.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number/{forwardingNumberId}

Request Parameters

Name Type Default Required Description
accountId string True
extensionId string True
forwardingNumberId string True

API Throttling Group

Light help_outline

Updates the existing forwarding number from the forwarding number list.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number/{forwardingNumberId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
forwardingNumberId string True Internal identifier of a forwarding number; returned in response in the 'id' field

API Throttling Group

Medium help_outline

Deletes a forwarding number from the forwarding number list by its ID.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number/{forwardingNumberId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
forwardingNumberId string True Internal identifier of a forwarding number

API Throttling Group

Medium help_outline

Call Handling Rules

Method Description

Returns call handling rules of an extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
enabledOnly boolean False false If true, then only active call handling rules are returned
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
page string 1 false
perPage string 100 false
type string false Filters custom call handling rules of the extension
view string Simple false

API Throttling Group

Medium help_outline

Creates a custom call handling rule for a particular caller ID.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns an call handling rule by ID.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ruleId string True Internal identifier of an answering rule. The value can be standard digital ID or specific ID - either 'business-hours-rule' or 'after-hours-rule'
showInactiveNumbers boolean False false Indicates whether inactive numbers should be returned or not

API Throttling Group

Light help_outline

Updates a custom call handling rule for a particular caller ID.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ruleId string True Internal identifier of an answering rule

API Throttling Group

Medium help_outline

Deletes a custom call handling rule by a particular ID.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ruleId string True Internal identifier of an answering rule

API Throttling Group

Medium help_outline

Returns a list of company call handling rules.

GET /restapi/v1.0/account/{accountId}/answering-rule

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items per page)

API Throttling Group

Medium help_outline

Create Company Call Handling Rule

Creates call handling rule on account level.

POST /restapi/v1.0/account/{accountId}/answering-rule

Returns a company call handling rule by ID.

GET /restapi/v1.0/account/{accountId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
ruleId string True Internal identifier of an answering rule. The value can be standard digital ID or specific ID - either 'business-hours-rule' or 'after-hours-rule'

API Throttling Group

Light help_outline

Updates a company call handling rule.

PUT /restapi/v1.0/account/{accountId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
ruleId string True Internal identifier of an answering rule. The value can be standard digital ID or specific ID - either 'business-hours-rule' or 'after-hours-rule'

API Throttling Group

Medium help_outline

Deletes a company custom call handling rule by a particular ID.

DELETE /restapi/v1.0/account/{accountId}/answering-rule/{ruleId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
ruleId string True Internal identifier of an answering rule

API Throttling Group

Medium help_outline

Call Log

Method Description

Returns call log records filtered by parameters specified.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateFrom string false The start datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is dateTo minus 24 hours
dateTo string false The end datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time
direction array false The direction for the resulting records. If not specified, both inbound and outbound records are returned. Multiple values are accepted
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
extensionNumber string false Extension number of a user. If specified, returns call log for a particular extension only
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)
phoneNumber string false Phone number of a caller/callee. If specified, returns all calls (both incoming and outcoming) with the phone number specified
recordingType string false Type of a call recording. If not specified, then calls without recordings are also returned
sessionId string false Internal identifier of a session
showBlocked boolean True false If 'True' then calls from/to blocked numbers are returned
showDeleted boolean False false If 'True' then deleted calls are returned
transport array false Call transport type. 'PSTN' specifies that a call leg is initiated from the PSTN network provider; 'VoIP' - from an RC phone. By default this filter is disabled
type array false Call type of a record. It is allowed to specify more than one type. If not specified, all call types are returned. Multiple values are accepted
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync
withRecording boolean False false **Deprecated**. Supported for compatibility reasons. `True` if only recorded calls are returned. If both `withRecording` and `recordingType` are specified, then `withRecording` is ignored

API Throttling Group

Heavy help_outline

Deletes filtered call log records.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateTo string false The end datetime for records deletion in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Synchronizes call log records.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log-sync

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateFrom string false The start datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is the current moment
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
recordCount integer false For 'FSync' the parameter is mandatory, it limits the number of records to be returned in response. For 'ISync' it specifies with how many records to extend sync Frame to the past, the maximum number of records is 250
showDeleted boolean False false Supported for ISync. If 'True' then deleted call records are returned
statusGroup array false Type of calls to be returned. The default value is 'All'
syncToken string false Value of syncToken property of last sync request response
syncType string FSync false Type of synchronization
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync

API Throttling Group

Heavy help_outline

Returns call log records by ID.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log/{callRecordId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
callRecordId array True
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
view string Simple false View of call records. The view value specified for 'FSync' will also be applied for 'ISync' by default, since it cannot be changed for ISync

API Throttling Group

Heavy help_outline

Returns records of all extension calls that are in progress, ordered by start time in descending order.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/active-calls

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
direction array false The direction for the result records. If not specified, both inbound and outbound records are returned. Multiple values are accepted
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)
type array false Call type of a record. If not specified, all call types are returned. Multiple values are accepted
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync

API Throttling Group

Heavy help_outline

Returns call log records filtered by parameters specified.

GET /restapi/v1.0/account/{accountId}/call-log

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateFrom string false The start datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is dateTo minus 24 hours
dateTo string false The end datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time
direction array false The direction for the result records. If not specified, both inbound and outbound records are returned. Multiple values are accepted
extensionNumber string false Extension number of a user. If specified, returns call log for a particular extension only
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
phoneNumber string false Phone number of a caller/call recipient. If specified, returns all calls (both incoming and outcoming) with the phone number specified. Cannot be specified together with the extensionNumber filter
recordingType string false Type of a call recording. If not specified, then calls without recordings are also returned
sessionId string false Internal identifier of a call session
type array false Call type of a record. If not specified, all call types are returned. Multiple values are accepted
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync
withRecording boolean false **Deprecated**. Supported for compatibility reasons only. `true` if only recorded calls are returned. The default value is `false`. If both `withRecording` and `recordingType` are specified, `withRecording` is ignored

API Throttling Group

Heavy help_outline

Synchronizes company call log records.

GET /restapi/v1.0/account/{accountId}/call-log-sync

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateFrom string false The start datetime for resulting records in (ISO 8601)[https://en.wikipedia.org/wiki/ISO_8601] format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is the current moment
recordCount integer false For 'FSync' the parameter is mandatory, it limits the number of records to be returned in response. For 'ISync' it specifies with how many records to extend sync frame to the past, the maximum number of records is 250
showDeleted boolean False false Supported for ISync. If 'True' then deleted call records are returned
statusGroup array false Type of calls to be returned.
syncToken string false Value of syncToken property of last sync request response
syncType string FSync false Type of synchronization.
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync

API Throttling Group

Heavy help_outline

Returns individual call log record(s) by ID(s). Batch request is supported.

GET /restapi/v1.0/account/{accountId}/call-log/{callRecordId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
callRecordId string True Internal identifier of a call log record
view string Simple false View of call records. The view value specified for 'FSync' will also be applied for 'ISync' by default, since it cannot be changed for ISync

API Throttling Group

Heavy help_outline

Returns records of all calls that are in progress, ordered by start time in descending order.

GET /restapi/v1.0/account/{accountId}/active-calls

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
direction array false The direction for the result records. If not specified, both inbound and outbound records are returned. Multiple values are accepted
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
transport array false Call transport type. 'PSTN' specifies that a call leg is initiated from the PSTN network provider; 'VoIP' - from an RC phone. By default this filter is disabled
type array false Call type of a record. If not specified, all call types are returned. Multiple values are accepted
view string Simple false View of call records. The same view parameter specified for FSync will be applied for ISync, the view cannot be changed for ISync

API Throttling Group

Heavy help_outline

Call Monitoring Groups

Method Description

Returns call monitoring groups that can be filtered by some extension.

GET /restapi/v1.0/account/{accountId}/call-monitoring-groups

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
memberExtensionId string false Internal identifier of an extension that is a member of every group within the result
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Medium help_outline

Create Call Monitoring Group

Creates a new call monitoring group.

POST /restapi/v1.0/account/{accountId}/call-monitoring-groups

Updates call monitoring group name by ID.

PUT /restapi/v1.0/account/{accountId}/call-monitoring-groups/{groupId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True Internal identifier of a call monitoring group

API Throttling Group

Medium help_outline

Removes information about the given call monitoring group.

DELETE /restapi/v1.0/account/{accountId}/call-monitoring-groups/{groupId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True

API Throttling Group

Medium help_outline

Returns call monitoring group members.

GET /restapi/v1.0/account/{accountId}/call-monitoring-groups/{groupId}/members

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Medium help_outline

Updates call monitoring groups.

POST /restapi/v1.0/account/{accountId}/call-monitoring-groups/{groupId}/bulk-assign

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True

API Throttling Group

Heavy help_outline

Call Queues

Method Description

Returns call queue group list.

GET /restapi/v1.0/account/{accountId}/call-queues

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
memberExtensionId string false Internal identifier of an extension that is a member of every group within the result
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Medium help_outline

Returns basic information on a call queue group extension.

GET /restapi/v1.0/account/{accountId}/call-queues/{groupId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True

API Throttling Group

Light help_outline

Updates information on a call queue group extension.

PUT /restapi/v1.0/account/{accountId}/call-queues/{groupId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True

API Throttling Group

Light help_outline

Returns call queue group members.

GET /restapi/v1.0/account/{accountId}/call-queues/{groupId}/members

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Updates a call queue group.

POST /restapi/v1.0/account/{accountId}/call-queues/{groupId}/bulk-assign

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True

API Throttling Group

Heavy help_outline

Updates the list of call queues where the user is an agent. This is a full update request, which means that if any queue where the user is an agent is not mentioned in request, then the user is automatically removed from this queue.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-queues

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Viewing user account info (including name, business name, address and phone number/account number). Please note, that this method is deprecated and legacy 'Department' entity corresponds to 'Call Queue' in modern RingCentral product terminology. In order to retrieve call queue members please use the following method GET/restapi/v1.0/account/{accountId}/call-queues/{groupId}/members.

GET /restapi/v1.0/account/{accountId}/department/{departmentId}/members

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
departmentId integer True Internal identifier of a Department extension (same as extensionId but only the ID of a department extension is valid). Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Assign Multiple Department Members

Adds and/or removes multiple call queue members. Please note, that this method is deprecated and legacy 'Department' entity corresponds to 'Call Queue' in modern RingCentral product terminology. In order to assign multiple call queue members please use the following method POST/restapi/v1.0/account/{accountId}/call-queues/{groupId}/bulk-assign.

POST /restapi/v1.0/account/{accountId}/department/bulk-assign

Call Recording Settings

Method Description
Get Call Recording Settings

Returns call recording settings.

GET /restapi/v1.0/account/{accountId}/call-recording

Update Call Recording Settings

Updates current call recording settings.

PUT /restapi/v1.0/account/{accountId}/call-recording

Get Call Recording Extension List

Returns the list of extensions to be recorded.

GET /restapi/v1.0/account/{accountId}/call-recording/extensions

Update Call Recording Extension List

Creates or updates the list of extensions to be recorded.

POST /restapi/v1.0/account/{accountId}/call-recording/bulk-assign

Returns call recording custom greetings.

GET /restapi/v1.0/account/{accountId}/call-recording/custom-greetings

Request Parameters

Name Type Default Required Description
accountId string True
type string false

API Throttling Group

Medium help_outline

Delete Call Recording Custom Greeting List

Deletes call recording custom greetings.

DELETE /restapi/v1.0/account/{accountId}/call-recording/custom-greetings

Deletes call recording custom greeting(s).

DELETE /restapi/v1.0/account/{accountId}/call-recording/custom-greetings/{greetingId}

Request Parameters

Name Type Default Required Description
accountId string True
greetingId string True

API Throttling Group

Medium help_outline

Call Recordings

Method Description

Returns call recordings by ID(s).

GET /restapi/v1.0/account/{accountId}/recording/{recordingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
recordingId string True Internal identifier of a recording (returned in Call Log)

API Throttling Group

Heavy help_outline

Returns media content of a call recording.

GET /restapi/v1.0/account/{accountId}/recording/{recordingId}/content

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
recordingId string True Internal identifier of a recording (returned in Call Log)

API Throttling Group

Heavy help_outline

Chats

Method Description

Returns the list of chats where the user is a member and also public teams that can be joined. All records in response are sorted by creation time of a chat in ascending order. Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name).

GET /restapi/v1.0/glip/chats

Request Parameters

Name Type Default Required Description
pageToken string false Pagination token.
recordCount integer 30 false Number of chats to be fetched by one request. The maximum value is 250, by default - 30.
type array false Type of chats to be fetched. By default all type of chats will be fetched

API Throttling Group

Medium help_outline

Get Chat

Returns information about a chat by ID. Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name)."

GET /restapi/v1.0/glip/chats/{chatId}

Returns recent chats where the user is a member. All records in response are sorted by the lastModifiedTime in descending order (the latest changed chat is displayed first on page). Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name)."

GET /restapi/v1.0/glip/recent/chats

Request Parameters

Name Type Default Required Description
recordCount integer 30 false Max number of chats to be fetched by one request (Not more than 250).
type array false Type of chats to be fetched. By default all chat types are returned

API Throttling Group

Light help_outline

Get Favorite Chats

Returns a list of the current user's favorite chats. Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name)."

GET /restapi/v1.0/glip/favorites

Add Chat to Favorites

Adds the specified chat to the users's list of favorites. Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name)."

POST /restapi/v1.0/glip/chats/{chatId}/favorite

Remove Chat from Favorites

Removes the specified chat from the users's list of favorites.

POST /restapi/v1.0/glip/chats/{chatId}/unfavorite

Mark Chat as Read

Sets the specified chat status to 'Read' for the current user.

POST /restapi/v1.0/glip/chats/{chatId}/read

Mark Chat as Unread

Sets the specified chat status to 'Unread' for the current user. Note 'Chat' is a general name for all types of threads icluding Personal (user's own me-chat), Direct (one on one chat), Group (chat of 3-15 participants without specific name), Team (chat of 2 and more participants, with a specific name), Everyone (company chat including all employees, with a specific name)."

POST /restapi/v1.0/glip/chats/{chatId}/unread

Returns the list of groups where the user is a member.

GET /restapi/v1.0/glip/groups

Request Parameters

Name Type Default Required Description
pageToken string false Pagination token.
recordCount integer 30 false Number of groups to be fetched by one request. The maximum value is 250, by default - 30
type string false Type of groups to be fetched (by default all type of groups will be fetched)

API Throttling Group

Medium help_outline

Create Group

Creates a new private chat/team.

POST /restapi/v1.0/glip/groups

Get Group

Returns information about a group or multiple groups by their ID(s). Batch request is supported.

GET /restapi/v1.0/glip/groups/{groupId}

Edit Group Members

Updates group members. Please note: Only groups of 'Team' type can be updated. Currently only one operation at a time (either adding or removal) is supported.

POST /restapi/v1.0/glip/groups/{groupId}/bulk-assign

Company

Method Description
Get Account Info

Returns basic information about a particular RingCentral customer account.

GET /restapi/v1.0/account/{accountId}

Get Account Business Address

Returns business address of a company.

GET /restapi/v1.0/account/{accountId}/business-address

Update Company Business Address

Updates the business address of a company that account is linked to. Batch request is supported.

PUT /restapi/v1.0/account/{accountId}/business-address

Get Account Service Info

Returns the information about service plan, available features and limitations for a particular RingCentral customer account.

GET /restapi/v1.0/account/{accountId}/service-info

Returns the list of domestic countries by contracted country and brand of the account.

GET /restapi/v1.0/dictionary/brand/{brandId}/contracted-country/{contractedCountryId}

Request Parameters

Name Type Default Required Description
brandId string True Internal identifier of a brand
contractedCountryId string True Internal identifier of a country
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Conversations

Method Description

Returns the list of conversations where the user is a member. All records in response are sorted by creation time of a conversation in ascending order. Conversation is a chat of the Group type.

GET /restapi/v1.0/glip/conversations

Request Parameters

Name Type Default Required Description
pageToken string false Pagination token.
recordCount integer 30 false Number of conversations to be fetched by one request. The maximum value is 250, by default - 30

API Throttling Group

Medium help_outline

Create/Open Conversation

Creates a new conversation or opens the existing one. If the conversation already exists, then its ID will be returned in response. A conversation is an adhoc discussion between a particular set of users, not featuring any specific name or description; it is a chat of 'Group' type. If you add a person to the existing conversation (group), it creates a whole new conversation.

POST /restapi/v1.0/glip/conversations

Get Conversation

Returns information about the specified conversation, including the list of conversation participants. A conversation is an adhoc discussion between a particular set of users, not featuring any specific name or description; it is a chat of 'Group' type. If you add a person to the existing conversation, it creates a whole new conversation.

GET /restapi/v1.0/glip/conversations/{chatId}

Custom Fields

Method Description
Get Custom Field List

Returns the list of created custom fields.

GET /restapi/v1.0/account/{accountId}/custom-fields

Create Custom Field

Creates custom field attached to the object.

POST /restapi/v1.0/account/{accountId}/custom-fields

Updates custom field by ID specified in path.

PUT /restapi/v1.0/account/{accountId}/custom-fields/{fieldId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
fieldId string True Custom field identifier

API Throttling Group

Light help_outline

Deletes custom field(s) by ID(s) with the corresponding values.

DELETE /restapi/v1.0/account/{accountId}/custom-fields/{fieldId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
fieldId string True Custom field identifier

API Throttling Group

Light help_outline

Device SIP Registration

Method Description
Register Device

Creates SIP registration of a device/application (WebPhone, Mobile, softphone).

POST /restapi/v1.0/client-info/sip-provision

Devices

Method Description

Returns account device(s) by their ID(s).

GET /restapi/v1.0/account/{accountId}/device/{deviceId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
deviceId integer True Internal identifier of a device
syncEmergencyAddress boolean False false Specifies if emergency address should be synchronized or not

API Throttling Group

Light help_outline

Updates account device(s) by their ID(s).

PUT /restapi/v1.0/account/{accountId}/device/{deviceId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
deviceId string True
prestatement boolean false

API Throttling Group

Medium help_outline

GET /restapi/v1.0/account/{accountId}/device/{deviceId}/sip-info

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
deviceId string True Internal identifier of a device

API Throttling Group

Light help_outline

Returns devices of the extension(s) by their ID(s). Batch request is supported

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/device

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
feature string false Device feature or multiple features supported
linePooling string false Pooling type of a device
page string 1 false Number of a page to be returned
perPage string 100 false Number of records per page to be returned

API Throttling Group

Light help_outline

Extensions

Method Description

Returns the list of extensions created for a particular account. All types of extensions are included in this list.

GET /restapi/v1.0/account/{accountId}/extension

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
email string false Extension email address. Multiple values are accepted
extensionNumber string false Number of extension to be retrieved
page integer 1 false Indicates the page number to retrieve. Only positive number values are allowed
perPage integer 100 false Indicates the page size (number of items)
status array false Extension current state. Multiple values are supported. If 'Unassigned' is specified, then extensions without `extensionNumber` attribute are returned. If not specified, then all extensions are returned.
type array false Extension type. Multiple values are supported. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology

API Throttling Group

Medium help_outline

Create Extension

Creates an extension.

POST /restapi/v1.0/account/{accountId}/extension

Returns the list of user templates for the current account.

GET /restapi/v1.0/account/{accountId}/templates

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
page string false
perPage string false
type string false

API Throttling Group

Medium help_outline

Returns the user template by ID.

GET /restapi/v1.0/account/{accountId}/templates/{templateId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
templateId string True

API Throttling Group

Light help_outline

Update Multiple Extensions

Updates multiple extensions at once. Maximum 500 extensions can be updated per request.

POST /restapi/v1.0/account/{accountId}/extension-bulk-update

Returns the status of multiple extension update task

GET /restapi/v1.0/account/{accountId}/extension-bulk-update/tasks/{taskId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
taskId string True Internal identifier of a task

API Throttling Group

Light help_outline

External Contacts

Method Description

Returns user personal contacts.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
phoneNumber array false
sortBy array false Sorts results by the specified property
startsWith string false If specified, only contacts whose First name or Last name start with the mentioned substring are returned. Case-insensitive

API Throttling Group

Heavy help_outline

Creates personal user contact.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dialingPlan string false A country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. The default value is home country of the current extension
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns contact(s) by ID(s). Batch request is supported.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
contactId integer True Internal identifier of a contact record in the RingCentral database
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Updates personal contact information by contact ID(s). Batch request is supported

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
contactId integer True Internal identifier of a contact record in the RingCentral database
dialingPlan string false A country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. The default value is home country of the current extension
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Deletes contact(s) by ID(s). Batch request is supported.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
contactId integer True Internal identifier of a contact record in the RingCentral database
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Synchronizes user contacts.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/address-book-sync

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
pageId integer false Internal identifier of a page. It can be obtained from the 'nextPageId' parameter passed in response body
perPage integer false Number of records per page to be returned. The max number of records is 250, which is also the default. For 'FSync' if the number of records exceeds the parameter value (either specified or default), all of the pages can be retrieved in several requests. For 'ISync' if the number of records exceeds the page size, the number of incoming changes to this number is limited
syncToken string false Value of syncToken property of the last sync request response
syncType string false Type of synchronization

API Throttling Group

Heavy help_outline

Returns the list of favorite contacts of the current extension. Favorite contacts include both company contacts (extensions) and personal contacts (address book records).

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/favorite

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates the list of favorite contacts of the current extension. Favorite contacts include both company contacts (extensions) and personal contacts (address book records).Please note: currently personal address book size is limited to 10 000 contacts.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/favorite

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Update Multiple Contacts

Uploads multiple contacts for multiple extensions at once. Maximum 500 extension, each up to 10000 contacts, can be updated per request.

POST /restapi/v1.0/account/{accountId}/address-book-bulk-upload

Returns the status of a task on adding multiple contacts to multiple extensions.

GET /restapi/v1.0/account/{accountId}/address-book-bulk-upload/tasks/{taskId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
taskId string True Internal identifier of a task

API Throttling Group

Light help_outline

Fax

Method Description

Creates and sends/resends a fax message. Resend can be implemented if sending has failed. Fax attachment size (both single and total) is limited to 50Mb.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/fax

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account (integer) or tilde (~) to indicate the account which was logged-in within the current session.
extensionId string ~ True Internal identifier of an extension (integer) or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns fax cover pages available for the current extension.

GET /restapi/v1.0/dictionary/fax-cover-page

Request Parameters

Name Type Default Required Description
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Features

Method Description

Returns the list of supported features and information on their availability for the current extension. Specific feature(s) might be checked by providing featureId query param. Multiple values supported, format: ?featureId=Feature1&featureId=Feature2. To get only available features in order to decrease response size, availableOnly=true query param might be specified. In case the feature is available for the current user, "available": true is returned in the response for the record with corresponding feature id. Otherwise, additional attribute reason is returned with the appropriate code: * ServicePlanLimitation - the feature not included to the account service plan; * AccountLimitation - the feature is turned off for the account; * ExtensionTypeLimitation - the feature is not applicable for the extension type; * ExtensionLimitation - the feature is not available for the extension, e.g., additional license required; * InsufficientPermissions - required permission not granted to the current user (not the one, who is specified in the URL, but the one who's access token is used); * ConfigurationLimitation - the feature is turned off for the extension, e.g., by the account administrator.

Also, some feature may have some additional parameters, e.g., limits, which are returned in params attribute as a name-value collection:

{
  "id": "HUD",
  "available": true,
  "params": [
    {
      "name": "limitMax",
      "value": "100"
    }
  ]
}

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/features

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
availableOnly boolean False false
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
featureId array false

API Throttling Group

Medium help_outline

Glip Compliance Exports

Method Description

Returns the list of Glip data export tasks.

GET /restapi/v1.0/glip/data-export

Request Parameters

Name Type Default Required Description
page integer 1 false Page number to be retrieved; value range is > 0
perPage integer 30 false Number of records to be returned per page; value range is 1 - 250
status string false Status of the task(s) to be returned. Multiple values are supported

API Throttling Group

Medium help_outline

Create Data Export Task

Creates a task for Glip data export and returns a link at which the exported data will be available in future once the task is implemented. The exported data can be downloaded by calling Get Data Export Task method with the specified task ID. Simultaneously no more than 2 tasks per company can be created.

POST /restapi/v1.0/glip/data-export

Get Data Export Task

Returns the links for downloading Glip data exported within the specified task. If the export task is still in progress, then only the task status will be returned. If the data is ready for downloading, then the list of URLs will be returned.

GET /restapi/v1.0/glip/data-export/{taskId}

Returns the specified dataset by ID. Each dataset is a ZIP archive the size of which is limited to 1 Gb.

GET /restapi/v1.0/glip/data-export/{taskId}/datasets/{datasetId}

Request Parameters

Name Type Default Required Description
datasetId string True Internal identifier of a dataset
taskId string True Internal identifier of a task

API Throttling Group

Heavy help_outline

Glip Profile

Method Description
Get Person

Returns a user or multiple users by their ID(s). Batch request is supported.

GET /restapi/v1.0/glip/persons/{personId}

Get Company Info

Returns information about one or more companies by their IDs.

GET /restapi/v1.0/glip/companies/{companyId}

Get Preferences

Returns information about user preferences.

GET /restapi/v1.0/glip/preferences

Glip Webhooks

Method Description
Get Webhooks in Group

Returns webhooks which are available for the current user by group ID.

GET /restapi/v1.0/glip/groups/{groupId}/webhooks

Create Webhook in Group

Creates a new webhook.

POST /restapi/v1.0/glip/groups/{groupId}/webhooks

Get Webhooks

Returns the list of all webhooks associated with the current account.

GET /restapi/v1.0/glip/webhooks

Get Webhook

Returns webhooks(s) with the specified id(s).

GET /restapi/v1.0/glip/webhooks/{webhookId}

Delete Webhook

Deletes a webhook by ID.

DELETE /restapi/v1.0/glip/webhooks/{webhookId}

Activate Webhook

Activates a webhook by ID.

POST /restapi/v1.0/glip/webhooks/{webhookId}/activate

Suspend Webhook

Suspends a webhook by ID.

POST /restapi/v1.0/glip/webhooks/{webhookId}/suspend

Greetings

Method Description

Returns the list of predefined standard greetings. Custom greetings recorded by user are not returned in response to this request. See Get Extension Custom Greetings.

GET /restapi/v1.0/dictionary/greeting

Request Parameters

Name Type Default Required Description
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted.
perPage integer 100 false Indicates the page size (number of items).
type string false Type of a greeting, specifying the case when the greeting is played
usageType string false Usage type of a greeting, specifying if the greeting is applied for user extension or department (call queue) extension

API Throttling Group

Medium help_outline

Get Standard Greeting

Returns a standard greeting by ID.

GET /restapi/v1.0/dictionary/greeting/{greetingId}

Create Company Greeting

Creates a custom company greeting.

POST /restapi/v1.0/account/{accountId}/greeting

Creates custom greeting for an extension user.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/greeting

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
apply boolean True false Specifies whether to apply an answering rule or not. If set to true then `answeringRule` parameter is mandatory. If set to false, then the answering rule is not applied even if specified
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns a custom user greeting by ID.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/greeting/{greetingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
greetingId integer True Internal identifier of a greeting

API Throttling Group

Medium help_outline

High Volume SMS

Method Description
Send A2P SMS

Allows to send high volume of A2P (Application-to-Person) SMS messages (in message batches). Only phone number with the A2PSmsSender feature can be used as a sender.

POST /restapi/v1.0/account/{accountId}/a2p-sms/batch

Returns the details of an A2P SMS message by ID.

GET /restapi/v1.0/account/{accountId}/a2p-sms/messages/{messageId}

Request Parameters

Name Type Default Required Description
false
messageId integer True Internal identifier of a message to be retrieved

API Throttling Group

Light help_outline

Returns information on a message batch.

GET /restapi/v1.0/account/{accountId}/a2p-sms/batch/{batchId}

Request Parameters

Name Type Default Required Description
false
false

API Throttling Group

Light help_outline

Returns the list of outbound/inbound A2P messages sent from/to A2P phone numbers of the current account. The list can be filtered by message batch ID and/or phone number.

GET /restapi/v1.0/account/{accountId}/a2p-sms/messages

Request Parameters

Name Type Default Required Description
false
batchId string False Internal identifier of a message batch used for filtering records
dateFrom string False Date to filter message list result. Messages with `creationTime` later than or equal to `dateFrom` value are returned. The default value is 1 day before the current datetime
dateTo string False Date to filter message list result. Messages with `creationTime` earlier than `dateTo` value are returned. The default is the current datetime
direction string False Direction of a message to filter the message list result. By default there is no filter applied - both Inbound and Outbound messages are returned
pageToken string False Token of a page to be retrieved
perPage integer 1000 false Number of messages to be returned per request
phoneNumber array False List of phone numbers (specified in 'to' or 'from' fields of a message) to filter the results. Maximum number of phone numbers allowed to be specified as filters is 15
view string Simple False Indicates if the response has to be detailed, includes text in the response if detailed

API Throttling Group

Light help_outline

Returns the list of numbers opted out from the account. The list can be filtered by to/from phone number query parameters. Specifying text/csv in the Accept header downloads the data in CSV format.

GET /restapi/v1.0/account/{accountId}/a2p-sms/opt-outs

Request Parameters

Name Type Default Required Description
false
from string False The sender's phone number (`from` field) in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format for filtering messages
pageToken string false Token of the page to be retrieved
perPage integer 1000 false Number of records to be returned for the page
to string False The reciever's phone number (`to` field) in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format for filtering messages

API Throttling Group

Light help_outline

Internal Contacts

Method Description
Search Company Directory Entries

Returns contact information on corporate users of federated accounts according to the specified filtering and ordering.

POST /restapi/v1.0/account/{accountId}/directory/entries/search

Returns contact information on a particular corporate user of a federated account.

GET /restapi/v1.0/account/{accountId}/directory/entries/{entryId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
entryId string True Internal identifier of extension to read information for

API Throttling Group

Medium help_outline

Returns contact information on corporate users of federated accounts. Please note: 1. User, DigitalUser, VirtualUser and FaxUser types are returned as User type. 2. ApplicationExtension type is not returned. 3. Only extensions in Enabled, Disabled and NotActivated state are returned.

GET /restapi/v1.0/account/{accountId}/directory/entries

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
If-None-Match string false If-None-Match
page string 1 false Page number
perPage integer 1000 false Records count to be returned per one page. The default value is 1000. Specific keyword values: `all` - all records are returned in one page; `max` - maximum count of records that can be returned in one page
showFederated boolean True false If 'True' then contacts of all accounts in federation are returned. If 'False' then only contacts of the current account are returned, and account section is eliminated in this case
siteId string false Internal identifier of the business site to which extensions belong
type string false Type of an extension. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology

API Throttling Group

Medium help_outline

Returns information on a federation and associated accounts.

GET /restapi/v1.0/account/{accountId}/directory/federation

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
RCExtensionId string false RCExtensionId

API Throttling Group

Medium help_outline

IVR

Method Description
Get IVR Prompt List

Returns the list of IVR prompts.

GET /restapi/v1.0/account/{accountId}/ivr-prompts

Create IVR Prompts

Creates an IVR prompt.

POST /restapi/v1.0/account/{accountId}/ivr-prompts

Returns an IVR prompt by ID.

GET /restapi/v1.0/account/{accountId}/ivr-prompts/{promptId}

Request Parameters

Name Type Default Required Description
accountId string True
promptId string True

API Throttling Group

Medium help_outline

Updates an IVR prompt by ID

PUT /restapi/v1.0/account/{accountId}/ivr-prompts/{promptId}

Request Parameters

Name Type Default Required Description
accountId string True
promptId string True

API Throttling Group

Medium help_outline

Deletes an IVR prompt by ID.

DELETE /restapi/v1.0/account/{accountId}/ivr-prompts/{promptId}

Request Parameters

Name Type Default Required Description
accountId string True
promptId string True

API Throttling Group

Heavy help_outline

Returns media content of an IVR prompt by ID.

GET /restapi/v1.0/account/{accountId}/ivr-prompts/{promptId}/content

Request Parameters

Name Type Default Required Description
accountId string True
promptId string True

API Throttling Group

Medium help_outline

Create IVR Menu

Creates a company IVR menu.

POST /restapi/v1.0/account/{accountId}/ivr-menus

Returns a company IVR menu by ID.

GET /restapi/v1.0/account/{accountId}/ivr-menus/{ivrMenuId}

Request Parameters

Name Type Default Required Description
accountId string True
ivrMenuId string True

API Throttling Group

Medium help_outline

Updates a company IVR menu by ID.

PUT /restapi/v1.0/account/{accountId}/ivr-menus/{ivrMenuId}

Request Parameters

Name Type Default Required Description
accountId string True
ivrMenuId string True

API Throttling Group

Medium help_outline

Meeting Configuration

Method Description

Returns user settings for meetings.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/user-settings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Get Locked Meeting Settings

Returns information on user meeting settings that are locked on account level and therefore cannot be changed by user.

GET /restapi/v1.0/account/{accountId}/meeting/locked-settings

Uploads profile picture for user meetings.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting-configuration/profile-image

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Returns information on dial-in numbers for meetings, support and international dial-in numbers URIs and meeting account information.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/service-info

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates personal meeting identifier.

PATCH /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/service-info

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns assistants information.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meetings-configuration/assistants

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Returns assisted users information.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meetings-configuration/assisted

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Meeting Management

Method Description

Returns a list of user meetings scheduled for the future (meetings of 'Instant' type are not included).

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Creates a new meeting.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns a particular meetings details by ID.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/{meetingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId string True Internal identifier of a RingCentral meeting

API Throttling Group

Light help_outline

Modifies a particular meeting.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/{meetingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId string True Internal identifier of a RingCentral meeting

API Throttling Group

Medium help_outline

Deletes a scheduled meeting.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/{meetingId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId string True Internal identifier of a RingCentral meeting

API Throttling Group

Medium help_outline

Ends a meetings which is in progress.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/{meetingId}/end

Request Parameters

Name Type Default Required Description
accountId string ~ True
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId string True Internal identifier of a RingCentral meeting

API Throttling Group

Medium help_outline

Returns a meeting invitation by ID.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting/{meetingId}/invitation

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of an account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId integer True Internal identifier of a RingCentral meeting

API Throttling Group

Light help_outline

Meeting Recordings

Method Description

Returns the list of meeting recordings for the current account.

GET /restapi/v1.0/account/{accountId}/meeting-recordings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
meetingId string false Internal identifier of a meeting. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
meetingStartTimeFrom string false Recordings of meetings started after the time specified will be returned. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
meetingStartTimeTo string false Recordings of meetings started before the time specified will be returned. The default value is current time. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
page integer false Page number
perPage integer 100 false Number of items per page. The `max` value is supported to indicate the maximum size - 300

API Throttling Group

Medium help_outline

Returns the list of meetings recordings for the current user.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/meeting-recordings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
meetingId string false Internal identifier of a meeting. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
meetingStartTimeFrom string false Recordings of meetings started after the time specified will be returned. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
meetingStartTimeTo string false Recordings of meetings started before the time specified will be returned. The default value is current time. Either `meetingId` or `meetingStartTime`/`meetingEndTime` can be specified
page integer false Page number
perPage integer 100 false Number of items per page. The `max` value is supported to indicate the maximum size - 300

API Throttling Group

Medium help_outline

Message Exports

Method Description
Create Message Store Report

Creates a task to collect all account messages within the specified time interval. Maximum number of simaltaneous tasks per account is 2.

POST /restapi/v1.0/account/{accountId}/message-store-report

Returns the current status of a task on report creation.

GET /restapi/v1.0/account/{accountId}/message-store-report/{taskId}

Request Parameters

Name Type Default Required Description
accountId string True
taskId string True

API Throttling Group

Heavy help_outline

Returns the created report with message data not including attachments.

GET /restapi/v1.0/account/{accountId}/message-store-report/{taskId}/archive

Request Parameters

Name Type Default Required Description
accountId string True
taskId string True

API Throttling Group

Heavy help_outline

Returns one of the report archives with message contents in application/zip format.

GET /restapi/v1.0/account/{accountId}/message-store-report/{taskId}/archive/{archiveId}

Request Parameters

Name Type Default Required Description
accountId string True
archiveId string True
taskId string True

API Throttling Group

Heavy help_outline

Message Store

Method Description

Returns the list of messages from an extension mailbox.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
availability array false Specifies the availability status for the resulting messages. Multiple values are accepted
conversationId integer false Specifies the conversation identifier for the resulting messages
dateFrom string false The start datetime for resulting messages in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is dateTo minus 24 hours
dateTo string false The end datetime for resulting messages in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time
direction array false The direction for the resulting messages. If not specified, both inbound and outbound messages are returned. Multiple values are accepted
distinctConversations boolean false If 'True', then the latest messages per every conversation ID are returned
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageType array false The type of the resulting messages. If not specified, all messages without message type filtering are returned. Multiple values are accepted
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
phoneNumber string false The phone number. If specified, messages are returned for this particular phone number only
readStatus array false The read status for the resulting messages. Multiple values are accepted

API Throttling Group

Light help_outline

Deletes conversation(s) by conversation ID(s). Batch request is supported, max number of IDs passed as query/path parameters is 50. Alternative syntax is supported - user converations can be deleted by passing multiple IDs in request body as an array of string, max number of conversation IDs passed in request body is 100. In this case asterisk is used in the path instead of IDs

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
conversationId array false
dateTo string false Messages received earlier then the date specified will be deleted. The default value is current datetime
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
type string All false Type of messages to be deleted

API Throttling Group

Medium help_outline

Returns individual message record(s) by the given message ID(s). The length of inbound messages is unlimited. Batch request is supported.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/{messageId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageId integer True Internal identifier of a message

API Throttling Group

Light help_outline

Updates message(s) by ID(s). Currently only message read status can be updated. Batch request is supported, max number of IDs passed as query/path parameters is 50. Alternative syntax is supported - user messages can be updated by passing multiple IDs in request body as an array of string, max number of IDs passed in request body is 1000. In this case asterisk is used in the path instead of IDs.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/{messageId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
dateFrom string false
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageId array True Internal identifier of a message
type string false

API Throttling Group

Medium help_outline

Deletes message(s) by the given message ID(s). The first call of this method transfers the message to the 'Delete' status. The second call transfers the deleted message to the 'Purged' status. If it is required to make the message 'Purged' immediately (from the first call), then set the query parameter purge to 'True'.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/{messageId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
conversationId integer false Internal identifier of a message thread
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageId array True Internal identifier of a message
purge boolean False false If the value is 'True', then the message is purged immediately with all the attachments

API Throttling Group

Medium help_outline

Returns a specific message attachment data as media stream.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/{messageId}/content/{attachmentId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
attachmentId integer True Internal identifier of a message attachment
contentDisposition string Inline false Content disposition of a response
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageId integer True Internal identifier of a message
Range string false

API Throttling Group

Medium help_outline

Synchronizes messages.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-sync

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
conversationId integer false Conversation identifier for the resulting messages. Meaningful for SMS and Pager messages only.
dateFrom string false The start datetime for resulting messages in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is dateTo minus 24 hours
dateTo string false The end datetime for resulting messages in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time
direction array false Direction for the resulting messages. If not specified, both inbound and outbound messages are returned. Multiple values are accepted
distinctConversations boolean false If 'True', then the latest messages per every conversation ID are returned
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
messageType array false Type for the resulting messages. If not specified, all types of messages are returned. Multiple values are accepted
recordCount integer false Limits the number of records to be returned (works in combination with dateFrom and dateTo if specified)
syncToken string false Value of syncToken property of last sync request response
syncType string false Type of message synchronization

API Throttling Group

Light help_outline

Get Message Store Configuration

Returns message store settings.

GET /restapi/v1.0/account/{accountId}/message-store-configuration

Update Message Store Configuration

Updates message store settings.

PUT /restapi/v1.0/account/{accountId}/message-store-configuration

Notes

Method Description

Returns the list of notes created in the specified chat.

GET /restapi/v1.0/glip/chats/{chatId}/notes

Request Parameters

Name Type Default Required Description
chatId string True Internal identifier of a chat to fetch notes from.
creationTimeFrom string false The start datetime for resulting records in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone
creationTimeTo string false The end datetime for resulting records in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, e.g. 2019-03-10T18:23:45. The default value is Now.
creatorId string false Internal identifier of the user that created the note. Multiple values are supported
pageToken string false Pagination token
recordCount integer 30 false Max number of notes to be fetched by one request; the value range is 1-250.
status string false Status of notes to be fetched; if not specified all notes are fetched by default.

API Throttling Group

Heavy help_outline

Create Note

Creates a new note in the specified chat.

POST /restapi/v1.0/glip/chats/{chatId}/notes

Get Note

Returns the specified note(s). It is possible to fetch up to 50 notes per request.

GET /restapi/v1.0/glip/notes/{noteId}

Delete Note

Deletes the specified note.

DELETE /restapi/v1.0/glip/notes/{noteId}

Update Note

Edits a note. Notes can be edited by any user if posted to a chat. the user belongs to.

PATCH /restapi/v1.0/glip/notes/{noteId}

Lock Note

Locks a note providing the user with the unique write access for 5 hours.

POST /restapi/v1.0/glip/notes/{noteId}/lock

Unlock Note

Unlocks a note letting other users edit this note. Once the note is locked (by another user) it cannot be unlocked during 5 hours since the lock datetime.

POST /restapi/v1.0/glip/notes/{noteId}/unlock

Publish Note

Publishes a note making it visible to other users.

POST /restapi/v1.0/glip/notes/{noteId}/publish

OAuth 2.0

Method Description
Authorize

Returns a link to a login page location.

POST /restapi/oauth/authorize

Revoke Token

Revokes access/refresh token. Requests to this endpoint must be authenticated with HTTP Basic scheme using the application key and application secret as login and password, correspondingly.

POST /restapi/oauth/revoke

Get Token

Returns access tokens for making API requests

POST /restapi/oauth/token

Pager Messages

Method Description

Creates and sends an internal text message.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/company-pager

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Paging Only Groups

Method Description

Returns the list of users allowed to page this group.

GET /restapi/v1.0/account/{accountId}/paging-only-groups/{pagingOnlyGroupId}/users

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
pagingOnlyGroupId string True Internal identifier of a paging group
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Returns the list of paging devices assigned to this group.

GET /restapi/v1.0/account/{accountId}/paging-only-groups/{pagingOnlyGroupId}/devices

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
pagingOnlyGroupId string True Internal identifier of a paging group
perPage integer 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Adds and/or removes paging group users and devices.

POST /restapi/v1.0/account/{accountId}/paging-only-groups/{pagingOnlyGroupId}/bulk-assign

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
pagingOnlyGroupId string True Internal identifier of a paging group

API Throttling Group

Heavy help_outline

Phone Numbers

Method Description

Returns the list of phone numbers that are used by a particular extension, and can be filtered by the phone number type. The returned list contains all numbers which are directly mapped to a given extension plus the features and also company-level numbers which may be used when performing different operations on behalf of this extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/phone-number

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
page integer false Indicates the page number to retrieve. Only positive number values are allowed. Default value is '1'
perPage integer false Indicates the page size (number of items). If not specified, the value is '100' by default
status string false Status of a phone number. Multiple values are supported
usageType array false Usage type of a phone number

API Throttling Group

Light help_outline

Returns the list of phone numbers assigned to RingCentral customer account. Both company-level and extension-level numbers are returned.

GET /restapi/v1.0/account/{accountId}/phone-number

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
status string false Status of a phone number. Multiple values are supported
usageType array false Usage type of a phone number

API Throttling Group

Heavy help_outline

Returns the phone number(s) belonging to a certain account or extension by phoneNumberId(s). Batch request is supported.

GET /restapi/v1.0/account/{accountId}/phone-number/{phoneNumberId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
phoneNumberId integer True Internal identifier of a phone number

API Throttling Group

Light help_outline

Returns one or more parsed and/or formatted phone numbers that are passed as a string.

POST /restapi/v1.0/number-parser/parse

Request Parameters

Name Type Default Required Description
homeCountry string false Internal identifier of a home country. The default value is ISO code (ISO 3166) of the user's home country or brand country, if the user is undefined
nationalAsPriority boolean false The default value is 'False'. If 'True', the numbers that are closer to the home country are given higher priority

API Throttling Group

Light help_outline

Posts

Method Description

Returns information about the specified post.

GET /restapi/v1.0/glip/chats/{chatId}/posts/{postId}

Request Parameters

Name Type Default Required Description
chatId string True Internal identifier of a chat.
postId string True Internal identifier of a post.

API Throttling Group

Light help_outline

Deletes the specified post from the chat.

DELETE /restapi/v1.0/glip/chats/{chatId}/posts/{postId}

Request Parameters

Name Type Default Required Description
chatId string True Internal identifier of a chat.
postId string True Internal identifier of a post to be deleted.

API Throttling Group

Medium help_outline

Updates a specific post within a chat.

PATCH /restapi/v1.0/glip/chats/{chatId}/posts/{postId}

Request Parameters

Name Type Default Required Description
chatId string True Internal identifier of a chat.
postId string True Internal identifier of a post to be updated.

API Throttling Group

Medium help_outline

Returns a list of posts from the specified chat.

GET /restapi/v1.0/glip/chats/{chatId}/posts

Request Parameters

Name Type Default Required Description
chatId string True Internal identifier of a chat
pageToken string false Pagination token.
recordCount integer 30 false Max number of posts to be fetched by one request (not more than 250)

API Throttling Group

Medium help_outline

Create Post

Creates a post in the chat specified in path. Any mention can be added within the text attribute of the request body in .md format - ![:Type](id), where type is one of (Person, Team, File, Note, Task, Event, Link, Card) and id is a unique identifier of the mentioned object of the specified type. Attachments of the following types (File, Card, Event, Note) can also be added to a post by passing type and ID of attachment(s) in request body.

POST /restapi/v1.0/glip/chats/{chatId}/posts

Returns posts which are available for the current user by group ID.

GET /restapi/v1.0/glip/groups/{groupId}/posts

Request Parameters

Name Type Default Required Description
groupId string True Internal identifier of a group
pageToken string false Pagination token
recordCount integer 30 false Max number of records to be returned

API Throttling Group

Medium help_outline

Create Post in Group

Creates a new post in a group specified.

POST /restapi/v1.0/glip/groups/{groupId}/posts

Modifies text of a post.

PUT /restapi/v1.0/glip/groups/{groupId}/posts/{postId}/text

Request Parameters

Name Type Default Required Description
groupId string True Internal identifier of a group
postId string True Internal identifier of a post

API Throttling Group

Medium help_outline

Create Card

Creates a new message.

POST /restapi/v1.0/glip/cards

Get Card

Returns card(s) with given id(s).

GET /restapi/v1.0/glip/cards/{cardId}

Update Card

Updates a card.

PUT /restapi/v1.0/glip/cards/{cardId}

Delete Card

Deletes a card by ID.

DELETE /restapi/v1.0/glip/cards/{cardId}

Returns posts available for the current user by group ID.

GET /restapi/v1.0/glip/posts

Request Parameters

Name Type Default Required Description
groupId string false Identifier of a group to filter posts
pageToken string false Token of a page to be returned
recordCount integer 30 false Number of records to be returned. The maximum value is 250, by default - 30

API Throttling Group

Light help_outline

Create Post

Creates a post.

POST /restapi/v1.0/glip/posts

Presence

Method Description

Returns presence status of an extension or several extensions by their ID(s). Batch request is supported. The 'presenceStatus' is returned as Offline (the parameters 'telephonyStatus', 'message', 'userStatus' and 'dndStatus' are not returned at all) for the following extension types: Department/Announcement Only/Take Messages Only (Voicemail)/Fax User/Paging Only Group/Shared Lines Group/IVR Menu/Application Extension/Park Location.If the user requests his/her own presence status, the response contains actual presence status even if the status publication is turned off. Batch request is supported. For batch requests the number of extensions in one request is limited to 30. If more extensions are included in the request, the error code 400 Bad Request is returned with the logical error code InvalidMultipartRequest and the corresponding message 'Extension Presence Info multipart request is limited to 30 extensions'.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
detailedTelephonyState boolean false Whether to return detailed telephony state
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
sipData boolean false Whether to return SIP data

API Throttling Group

Light help_outline

Updates user-defined extension presence status, status message and DnD status by extension ID. Supported for regular User extensions only. The extension types listed do not support presence status: Department, Announcement Only, Take Messages Only (Voicemail), Fax User, Paging Only Group, Shared Lines Group, IVR Menu, Application Extension.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns presence status of all extensions of an account. Please note: The presenceStatus is returned as Offline (the parameters telephonyStatus, message, userStatus and dndStatus are not returned at all) for the following extension types: Department, Announcement Only, Voicemail (Take Messages Only), Fax User, Paging Only Group, Shared Lines Group, IVR Menu, Application Extension.

GET /restapi/v1.0/account/{accountId}/presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
detailedTelephonyState boolean false Whether to return detailed telephony state
page integer false Page number for account presence information
perPage integer false Number for account presence information items per page
sipData boolean false Whether to return SIP data

API Throttling Group

Heavy help_outline

Returns presence status of the call queue members.

GET /restapi/v1.0/account/{accountId}/call-queues/{groupId}/presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True Internal identifier of an call queue extension

API Throttling Group

Light help_outline

Updates presence status of the call queue members in the specified queue.

PUT /restapi/v1.0/account/{accountId}/call-queues/{groupId}/presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
groupId string True Internal identifier of a call queue extension

API Throttling Group

Medium help_outline

Returns a list of agent's call queues with the agent presence status (per queue)

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-queue-presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
editableMemberStatus boolean false Filtering by the flag 'Allow members to change their Queue Status'. If 'true' only queues where user can change his availability status are returned
extensionId string ~ True Internal identifier of an extension

API Throttling Group

Light help_outline

Updates availability of the agent for the call queues.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-queue-presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension

API Throttling Group

Medium help_outline

Returns the unified presence status of the requested user(s). The set of parameters returned by this method differs whether you return the requester's presence or any other user presence.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Updates the unified presence for the current user specified in path.

PATCH /restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Regional Settings

Method Description
Get Language List

Returns the information about supported languages.

GET /restapi/v1.0/dictionary/language

Get Language

Returns language by ID.

GET /restapi/v1.0/dictionary/language/{languageId}

Returns all the countries available for calling.

GET /restapi/v1.0/dictionary/country

Request Parameters

Name Type Default Required Description
freeSoftphoneLine boolean false Specifies if free phone line for softphone is available for a country or not
loginAllowed boolean false Specifies whether login with the phone numbers of this country is enabled or not
numberSelling boolean false Specifies if RingCentral sells phone numbers of this country
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
signupAllowed boolean false Indicates whether signup/billing is allowed for a country. If not specified all countries are returned (according to other filters specified if any)

API Throttling Group

Light help_outline

Get Country

Returns the information on a specific country.

GET /restapi/v1.0/dictionary/country/{countryId}

Returns all available locations for a certain state.

GET /restapi/v1.0/dictionary/location

Request Parameters

Name Type Default Required Description
orderBy string City false Sorts results by the property specified
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
stateId string false Internal identifier of a state
withNxx boolean false Specifies if nxx codes are returned

API Throttling Group

Light help_outline

Returns all the states of a certain country

GET /restapi/v1.0/dictionary/state

Request Parameters

Name Type Default Required Description
allCountries boolean false If set to 'True' then states for all countries are returned and `countryId` is ignored, even if specified. If the value is empty then the parameter is ignored
countryId integer false Internal identifier of a country
page integer 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage integer 100 false Indicates the page size (number of items)
withPhoneNumbers boolean False false If 'True', the list of states with phone numbers available for buying is returned

API Throttling Group

Light help_outline

Get State

Returns the information on a specific state.

GET /restapi/v1.0/dictionary/state/{stateId}

Returns all available timezones.

GET /restapi/v1.0/dictionary/timezone

Request Parameters

Name Type Default Required Description
page string 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage string 100 false Indicates the page size (number of items)

API Throttling Group

Light help_outline

Returns the information on a certain timezone.

GET /restapi/v1.0/dictionary/timezone/{timezoneId}

Request Parameters

Name Type Default Required Description
page string 1 false Indicates the page number to retrieve. Only positive number values are accepted
perPage string 100 false Indicates the page size (number of items)
timezoneId integer True Internal identifier of a timezone

API Throttling Group

Light help_outline

RingOut

Method Description

Makes a 2-leg RingOut call.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns the status of a 2-leg RingOut call.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out/{ringoutId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ringoutId string True Internal identifier of a RingOut call

API Throttling Group

Light help_outline

Cancels a 2-leg RingOut call.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out/{ringoutId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ringoutId string True Internal identifier of a RingOut call

API Throttling Group

Heavy help_outline

Makes a 2-leg RingOut call.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/ringout

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns status of a 2-leg RingOut call.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/ringout/{ringoutId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ringoutId integer True Internal identifier of a RingOut call

API Throttling Group

Light help_outline

Cancels a 2-leg RingOut call.

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}/ringout/{ringoutId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
ringoutId integer True Internal identifier of a RingOut call

API Throttling Group

Heavy help_outline

SCIM

Method Description
Get Service Provider Config

GET /scim/v2/ServiceProviderConfig

Get Service Provider Config

GET /scim/ServiceProviderConfig

GET /scim/v2/Users

Request Parameters

Name Type Default Required Description
count integer 100 false page size
filter string false only support 'userName' or 'email' filter expressions for now
startIndex integer 1 false start index (1-based)

API Throttling Group

Light help_outline

Create User

POST /scim/v2/Users

GET /scim/Users

Request Parameters

Name Type Default Required Description
count integer 100 false page size
filter string false only support 'userName' or 'email' filter expressions for now
startIndex integer 1 false start index (1-based)

API Throttling Group

Light help_outline

Create User

POST /scim/Users

Search/List Users

POST /scim/v2/Users/.search

Get User

GET /scim/v2/Users/{id}

Update/Replace User

PUT /scim/v2/Users/{id}

Delete User

DELETE /scim/v2/Users/{id}

Update/Patch User

PATCH /scim/v2/Users/{id}

SMS

Method Description

Creates and sends a new text message. You can send SMS messages simultaneously to different recipients up to 40 requests per minute; this limitation is relevant for all client applications. Sending and receiving SMS is available for Toll-Free Numbers within the USA. You can send up to 10 attachments in one MMS message; the size of all attachments linked is limited to 1500000 bytes.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/sms

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Creates and sends media messages. Sending MMS messages simultaneously to different recipients is limited up to 50 requests per minute; relevant for all client applications.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/mms

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Subscriptions

Method Description
Get Subscription List

Returns the list of subscriptions created by the logged-in user for the currently authorized client application.

GET /restapi/v1.0/subscription

Create Subscription

Creates a new subscription.

POST /restapi/v1.0/subscription

Get Subscription

Returns the requested subscription by ID.

GET /restapi/v1.0/subscription/{subscriptionId}

Update Subscription

Updates the existent subscription. The client application can extend/narrow the events for which it receives notifications within the frame of one subscription. If event filters are specified, calling this method modifies them for the existing subscription. The method also allows to set the subscription expiration time. If other than events and expiresIn parameters are passed in request they will be ignored. If the request body is empty then the specified subscription will be just renewed without any event filter change and with expiration time default.

PUT /restapi/v1.0/subscription/{subscriptionId}

Cancel Subscription

Cancels the existent subscription.

DELETE /restapi/v1.0/subscription/{subscriptionId}

Renew Subscription

Renews an existent subscription by posting request with an empty body.

POST /restapi/v1.0/subscription/{subscriptionId}/renew

Tasks

Method Description

Returns the list of tasks of the specified chat.

GET /restapi/v1.0/glip/chats/{chatId}/tasks

Request Parameters

Name Type Default Required Description
assigneeId array false Internal identifier of a task assignee
assigneeStatus string false Task execution status by assignee(-s) specified in assigneeId
assignmentStatus string false Task assignment status
chatId string True Internal identifier of a chat
creationTimeFrom string false The start datetime for resulting records in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, e.g. 2016-02-23T00:00:00
creationTimeTo string now false The end datetime for resulting records in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, e.g. 2019-03-10T18:23:45Z
creatorId array false Internal identifier of a task creator
pageToken string false Token of the current page. If token is omitted then the first page should be returned
recordCount integer 30 false Number of records to be returned per screen
status array false Task execution status

API Throttling Group

Heavy help_outline

Create Task

Creates a task in the specified chat.

POST /restapi/v1.0/glip/chats/{chatId}/tasks

Get Task

Returns information about the specified task(s) by ID(s).

GET /restapi/v1.0/glip/tasks/{taskId}

Delete Task

Deletes the specified task.

DELETE /restapi/v1.0/glip/tasks/{taskId}

Patch Task

Updates the specified task by ID.

PATCH /restapi/v1.0/glip/tasks/{taskId}

Complete Task

Completes a task in the specified chat.

POST /restapi/v1.0/glip/tasks/{taskId}/complete

Teams

Method Description

Returns the list of teams where the user is a member (both archived and active) combined with a list of public teams that can be joined by the current user. All records in response are sorted by creation time of a chat in ascending order. A team is a chat between 2 and more (unlimited number) participants assigned with specific name.

GET /restapi/v1.0/glip/teams

Request Parameters

Name Type Default Required Description
pageToken string false Pagination token.
recordCount integer 30 false Number of teams to be fetched by one request. The maximum value is 250, by default - 30

API Throttling Group

Medium help_outline

Create Team

Creates a team, and adds a list of people to the team. A team is a chat between 2 and more (unlimited number) participants assigned with specific name.

POST /restapi/v1.0/glip/teams

Get Team

Returns information about the specified team. A team is a chat between 2 and more participants assigned with specific name.

GET /restapi/v1.0/glip/teams/{chatId}

Delete Team

Deletes the specified team. A team is a chat between 2 and more (unlimited number) participants assigned with specific name.

DELETE /restapi/v1.0/glip/teams/{chatId}

Update Team

Updates the name and description of the specified team. A team is a chat between 2 and more (unlimited number) participants assigned with specific name.

PATCH /restapi/v1.0/glip/teams/{chatId}

Join Team

Adds the current user to the specified team. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/join

Leave Team

Removes the current user from the specified team. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/leave

Add Team Members

Adds members to the specified team. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/add

Remove Team Members

Removes members from the specified team. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/remove

Archive Team

Changes the status of the specified team to 'Archived'. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/archive

Unarchive Team

Changes the status of the specified team to 'Active'. A team is a chat between 2 and more participants assigned with specific name.

POST /restapi/v1.0/glip/teams/{chatId}/unarchive

Get Everyone Chat

Returns information about Everyone chat, which is a company level chat including all employees; assigned with specific name.

GET /restapi/v1.0/glip/everyone

Update Everyone Сhat

Updates Everyone chat information. Everyone chat is a company level chat including all employees; assigned with specific name.

PATCH /restapi/v1.0/glip/everyone

User Permissions

Method Description

Returns the list of user permissions granted at authorization procedure. Please note: Some permissions may be restricted by extension type.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Checks if a certain user permission is activated for a particular extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile/check

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
permissionId string false
targetExtensionId string false

API Throttling Group

Light help_outline

Method Description

Returns basic information about a particular extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates user settings.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Deletes extension(s) by ID(s). When an extension is being deleted the default API behaviour is as follows: ⋅⋅ user's direct numbers are preserved by becoming additional company numbers; ⋅⋅ user's digital lines (both device & associated phone number) are deleted. You can change this behaviour using the filters: .. create unassigned extensions for each digital line of the deleted extension by setting the query parameter savePhoneLines to true in request path; .. remove direct numbers of the deleted extension by setting the query parameter savePhoneNumbers to false in request path

DELETE /restapi/v1.0/account/{accountId}/extension/{extensionId}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
savePhoneLines boolean False false
savePhoneNumbers boolean True false

API Throttling Group

Medium help_outline

Returns information on an outbound caller ID of an extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates outbound caller ID information of an extension.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns the list of extensions with the information on grants given to the current extension regarding them. Currently the list of grants include: picking up a call, monitoring, calling or receiving a call on behalf of somebody, call delegation and calling paging groups.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/grant

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
extensionType string false Type of extension to be returned. Multiple values are supported. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
page string 1 false
perPage string 100 false

API Throttling Group

Light help_outline

Returns notification settings for the current extension.

Knowledge Article: User Settings - Set up Message Notifications

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/notification-settings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates notification settings for the current extension.

Knowledge Article: User Settings - Set up Message Notifications

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/notification-settings

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Returns a profile image of an extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/profile-image

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Updates the extension profile image

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/profile-image

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Uploads the extension profile image.

POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/profile-image

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Heavy help_outline

Returns scaled profile image of an extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/profile-image/{scaleSize}

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session
scaleSize string True Dimensions of a profile image which will be returned in response. If this path parameter is not specified in request URI then

API Throttling Group

Light help_outline

Returns the information on the Free Conference Calling (FCC) feature for a given extension.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/conferencing

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
countryId string false Internal identifier of a country. If not specified, the response is returned for the brand country
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Light help_outline

Updates the default conferencing number for the current extension. The number can be selected from conferencing numbers of the current extension. Updates the setting, allowing participants join the conference before host.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/conferencing

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the account logged-in within the current session

API Throttling Group

Medium help_outline

Video Configuration

Method Description

Returns information about video configuration of the current user.

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/video-configuration

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the current session account

API Throttling Group

Light help_outline

Allows to update user video settings, for example video provider.

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/video-configuration

Request Parameters

Name Type Default Required Description
accountId string ~ True Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session
extensionId string ~ True Internal identifier of an extension or tilde (~) to indicate the extension assigned to the current session account

API Throttling Group

Light help_outline