List Extensions (ringcentral_list-extensions)
List all extensions (users, call queues, and other extension types) created for the RingCentral account. Supports filtering by type/status and pagination.
Tool Input
typestring— Only return extensions of this type.(enum: "User", "FaxUser", "FlexibleUser", "VirtualUser", "DigitalUser", "Department", "Announcement", "Voicemail", "SharedLinesGroup", "PagingOnly", "IvrMenu", "ApplicationExtension", "ParkLocation", "Limited", "Bot", "ProxyAdmin", "DelegatedLinesGroup", "Site")
statusstring— Only return extensions in this state.(enum: "Enabled", "Disabled", "NotActivated", "Unassigned")
pageinteger— Which results page to fetch. Omit for page 1.
Tool Output
uristring— Link to the extension list resource.
recordsarrayrequired— Extensions matching the request filters.
[]object
idinteger— Internal identifier of the extension.
uristring— Canonical URI of the extension.
contactobject— Detailed contact information.
12 fields
firstNamestring— User's first name (User extension type only).
lastNamestring— User's last name (User extension type only).
namestring— Extension name (User type: concatenation of first + last name).
companystring— User's company name.
jobTitlestring— User's job title.
emailstring— User's contact email.
businessPhonestring— User's contact phone number, E.164 format.
mobilePhonestring— User's mobile (non toll-free) number, E.164 format.
businessAddressobject— User's business address.
5 fields
countrystring— Country name of the extension user's company.
statestring— State/province name (mandatory for US/UK/Canada).
citystring— City name.
streetstring— Street address.
zipstring— Zip/postal code.
emailAsLoginNameboolean— Whether the contact email is enabled as this user's login name.
pronouncedNameobject— How the user's name is pronounced.
3 fields
typestring— How the extension user's name is pronounced.(enum: "Default", "TextToSpeech", "Recorded")
textstring— Custom text (for the `TextToSpeech` type only).
promptobject— Custom recorded/TTS name prompt audio.
3 fields
idstring— Internal identifier of the pronounced-name prompt.
contentUristring— Link to the prompt audio resource.
contentTypestring— Content media type of the prompt audio (open string; mirrors the widened get-call-recording contentType).
departmentstring— User's department name.
extensionNumberstring— Extension short number.
namestring— Extension name.
permissionsobject— Admin/international-calling permissions.
2 fields
adminobject— Admin permission.
1 field
enabledboolean— Whether the Admin permission is enabled.
internationalCallingobject— International Calling permission.
1 field
enabledboolean— Whether the International Calling permission is enabled.
profileImageobject— Profile image information.
5 fields
uristringrequired— Link to the profile image (the only field returned when unset).
etagstring— Identifier of the image.
lastModifiedstring— When the image was last updated, ISO 8601.
contentTypestring— MIME type of the image.
scalesarray— Links to the profile image in different dimensions.
1 field
[]object
1 field
uristring— Link to this scaled profile image variant.
statusstring— Extension current state.
typestring— Extension type. Documented values (rc-platform.yml ~L30756–30782): User, FaxUser, FlexibleUser, VirtualUser, DigitalUser, Department, Announcement, Voicemail, SharedLinesGroup, PagingOnly, IvrMenu, ApplicationExtension, ParkLocation, Bot, Room, Limited, Site, ProxyAdmin, DelegatedLinesGroup, GroupCallPickup. RC also returns undocumented system types (e.g. CompanyExtension) — read as an open string.
subTypestring— Extension subtype, if applicable.(enum: "Unknown", "VideoPro", "VideoProPlus", "DigitalSignage", "Emergency")
callQueueInfoobject— Call Queue extension settings.
4 fields
slaGoalinteger— Target percentage of calls that must be answered within the SLA threshold.
slaThresholdSecondsinteger— Period, in seconds, considered an acceptable service level.
includeAbandonedCallsboolean— Whether abandoned calls are included in the service-level calculation.
abandonedThresholdSecondsinteger— Calls shorter than this, in seconds, are excluded from the abandoned-calls count.
hiddenboolean— Whether hidden from the company directory.
siteobject— Site the extension belongs to.
4 fields
idstring— Internal identifier of the site.
uristring— Link to the site resource.
namestring— Name of the site.
codestring— Site code value, if specified.
assignedCountryobject— Country assigned to the extension.
4 fields
idstring— Internal identifier of the assigned country.
uristring— Canonical URI of the assigned country resource.
isoCodestring— ISO 3166-1 alpha-2 country code.
namestring— Official name of the country.
costCenterobject— Cost center assigned to the extension.
2 fields
idstring— Internal identifier of the cost center.
namestring— Name of the cost center.
creationTimestring— When the extension was created, ISO 8601 (live-observed, undocumented field).
rolesarray— Roles assigned to the extension (live-observed field).
1 field
[]object
6 fields
uristring— Link to the role.
idstring— Internal identifier of the role.
autoAssignedboolean— Whether the role was auto-assigned.
displayNamestring— Display name of the role.
siteCompatibleboolean— Whether the role is site-compatible.
siteRestrictedboolean— Whether the role is site-restricted.
navigationobject— Links to other pages of the result set.
firstPageobject— Link to the first page.
uristring— Canonical URI to retrieve this particular page.
nextPageobject— Link to the next page.
uristring— Canonical URI to retrieve this particular page.
previousPageobject— Link to the previous page.
uristring— Canonical URI to retrieve this particular page.
lastPageobject— Link to the last page.
uristring— Canonical URI to retrieve this particular page.
pagingobject— Pagination metadata for `records`.
perPageintegerrequired— Page size — how many items are in each page.
pageinteger— 1-based current page number; omitted if the result is empty.
pageStartinteger— 0-based index of the first element on the current page.
pageEndinteger— 0-based index of the last element on the current page.
totalPagesinteger— Total number of pages in the dataset (may be omitted for performance reasons).
totalElementsinteger— Total number of elements in the dataset (may be omitted for performance reasons).
We're Adding More RingCentral Tools Constantly!
Don't see a specific RingCentral tool you need? Email [email protected] and we can add it.
RingCentral Frequently Asked Questions
What does the List Extensions tool do?
This page documents the List Extensions tool (ringcentral_list-extensions). List all extensions (users, call queues, and other extension types) created for the RingCentral account. Supports filtering by type/status and pagination. It is one of the RingCentral Identity tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.
What is the RingCentral integration?
The RingCentral integration connects your firm's RingCentral account to Weave. RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level. It groups 17 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.