DocumentationBlogSupport
Log inSign up
Log inSign up
BlogSupport
Build
Getting StartedPlatform Introduction
Embedded Apps
What's NewOverviewDeveloper GuideSidebar API Quick StartSubmission Checklist for Embedded Apps
Design Guidelines
MessagingMeetingsDevicesSidebarSidebar on Mobile
API Reference
BotsButtons and CardsIntegrationsBYODSService AppsService App GuestsService Apps G2GGuest IssuerWidgetsWebex ConnectLogin with WebexInstant ConnectInstant Connect Meeting LinksDeveloper SandboxBeta ProgramSubmit Your AppSupport PolicyFAQs
APIs
API Behavior ChangesPartners API GuideXML API DeprecationAccess the APIREST API BasicsCompliance
Webex APIs
Reference
Data Sources
Admin
OverviewAdmin APIsHybrid ServicesAuthentication
Guides
Hybrid ServicesWebhooksReal-time File DLP BasicsProvisioning APIsBackground ImagesAudit Events Error Reference
Reference
Admin Audit EventsAuthorizationsEventsGroupsHistorical AnalyticsHybrid ClustersHybrid ConnectorsLicensesMeeting QualitiesOrganization ContactsOrganizationsPartner ManagementPartner Reports/TemplatesPartner TagsPeopleRecording ReportRecordingsReport TemplatesReportsResource Group MembershipsResource GroupsRolesSecurity Audit EventsSession TypesSettingsSpace ClassificationsTracking CodesWorkspace LocationsWorkspace Metrics
Webex Calling Beta
Overview
Guides
Integrations and AuthorizationMetadata and Samples
Webex Calling
OverviewSDKs and ToolsWhat's New
Guides
Integrations and AuthorizationProvisioning APIsMetadata and SamplesBackground Images
Reference
Call Controls
POSTDial
POSTAnswer
POSTReject
POSTHangup
POSTHold
POSTResume
POSTMute
POSTUnmute
POSTDivert
POSTTransfer
POSTPark
POSTRetrieve
POSTStart Recording
POSTStop Recording
POSTPause Recording
POSTResume Recording
POSTTransmit DTMF
POSTPush
POSTPickup
POSTBarge In
GETList Calls
GETGet Call Details
GETList Call History
Call RoutingCall Settings For MeCalling Service SettingsClient Call SettingsConference ControlsConverged RecordingsDECT Devices SettingsDevice Call SettingsDevicesEmergency Services SettingsFeatures: Announcement PlaylistFeatures: Announcement RepositoryFeatures: Auto AttendantFeatures: Call ParkFeatures: Call PickupFeatures: Call QueueFeatures: Call RecordingFeatures: Customer Experience EssentialsFeatures: Hunt GroupFeatures: Operating ModesFeatures: Paging GroupFeatures: Single Number ReachLocation Call SettingsLocation Call Settings: Call HandlingLocation Call Settings: SchedulesLocation Call Settings: VoicemailLocationsNumbersPSTNPartner Reports/TemplatesPeopleRecording ReportReportsReports: Detailed Call HistorySend Activation EmailUser Call SettingsVirtual Line Call SettingsWorkspace Call SettingsWorkspaces
Webex for Broadworks
Overview
Guides
Integrations and AuthorizationDeveloper's Guide
Reference
BroadWorks Billing ReportsBroadWorks EnterprisesBroadWorks SubscribersBroadWorks Workspaces
Webex for Wholesale
Overview
Guides
Developer's Guide
Reference
Wholesale Billing ReportsWholesale Provisioning
Webex for UCM
Guides
Integrations and Authorization
Reference
UCM Profile
Contact Center
Overview
Reference
Data Sources
Customer Journey Data
Overview
Guides
Getting StartedFAQ
Devices
Overview
Guides
Devices
Reference
Device Call SettingsDevice ConfigurationsDevicesWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
Directory Services
Reference
Domain ManagementIdentity Organization
Meetings
Overview
Guides
Integrations and AuthorizationWebhooksWebinar GuideMeeting Resource Guide
Reference
Meeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportPeopleRecording ReportRecordingsSession TypesTracking CodesVideo MeshWebhooks
Messaging
Overview
Guides
BotsIntegrations and AuthorizationWebhooksButtons and Cards
Reference
Attachment ActionsEventsMembershipsMessagesPeopleRoom TabsRoomsTeam MembershipsTeamsWebhooks
SCIM 2
Overview
Reference
SCIM 2 BulkSCIM 2 GroupsSCIM 2 Users
Workspace Integrations
OverviewTechnical DetailsControl Hub Features
Webex Status API
Full API Reference
Admin Audit EventsAttachment ActionsAuthorizationsBroadWorks Billing ReportsBroadWorks EnterprisesBroadWorks SubscribersBroadWorks WorkspacesCall Controls
POSTDial
POSTAnswer
POSTReject
POSTHangup
POSTHold
POSTResume
POSTMute
POSTUnmute
POSTDivert
POSTTransfer
POSTPark
POSTRetrieve
POSTStart Recording
POSTStop Recording
POSTPause Recording
POSTResume Recording
POSTTransmit DTMF
POSTPush
POSTPickup
POSTBarge In
GETList Calls
GETGet Call Details
GETList Call History
Call RoutingCall Settings For MeCalling Service SettingsClient Call SettingsConference ControlsConverged RecordingsDECT Devices SettingsData SourcesDevice Call SettingsDevice ConfigurationsDevicesDomain ManagementEmergency Services SettingsEventsFeatures: Announcement PlaylistFeatures: Announcement RepositoryFeatures: Auto AttendantFeatures: Call ParkFeatures: Call PickupFeatures: Call QueueFeatures: Call RecordingFeatures: Customer Experience EssentialsFeatures: Hunt GroupFeatures: Operating ModesFeatures: Paging GroupFeatures: Single Number ReachGroupsGuests ManagementHistorical AnalyticsHybrid ClustersHybrid ConnectorsIdentity OrganizationIssuesLicensesLocation Call SettingsLocation Call Settings: Call HandlingLocation Call Settings: SchedulesLocation Call Settings: VoicemailLocationsMeeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportMembershipsMessagesNumbersOrganization ContactsOrganizationsPSTNPartner ManagementPartner Reports/TemplatesPartner TagsPeopleRecording ReportRecordingsReport TemplatesReportsReports: Detailed Call HistoryResource Group MembershipsResource GroupsRolesRoom TabsRoomsSCIM 2 BulkSCIM 2 GroupsSCIM 2 UsersSecurity Audit EventsSend Activation EmailSession TypesSettingsSiteSpace ClassificationsTeam MembershipsTeamsTracking CodesUCM ProfileUser Call SettingsVideo MeshVirtual Line Call SettingsWebhooksWholesale Billing ReportsWholesale ProvisioningWorkspace Call SettingsWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
API Changelog
SDKs
Space Meetings Migration
Calling
Introduction
Platform
Web
IntroductionQuickstart
Basics
AuthorizationCore ConceptsCalls
Advanced Features
Call SettingsContactsSupplementary ServicesVoicemailBackground Noise Reduction
Kitchen Sink
Meetings
Introduction
Platform
Web
IntroductionQuickstart
Basics
AuthorizationJoin a MeetingMigration To Improved MeetingsPasswords & CaptchasUnified Space Meetings
Advanced Features
Advanced ControlsDialing In and OutStreams & EffectsVideo Resolution
Multistream
Multistream Comprehensive GuideMultistream Quickstart
Migrating SDK V2 to V3
iOSAndroidBrowserNode.jsClick to Call
Developer CommunityCertifications

Call Controls

Call Control APIs in support of Webex Calling. All GET commands require the spark:calls_read scope while all other commands require the spark:calls_write scope.

Notes:

  • These APIs support 3rd Party Call Control only.

  • The Call Control APIs are only for use by Webex Calling Multi Tenant users and not applicable for users hosted on UCM, including Dedicated Instance users.

Method
Description
POSThttps://webexapis.com/v1/telephony/calls/dial
Dial
https://webexapis.com/v1/telephony/calls/dial
POSTDial
POSThttps://webexapis.com/v1/telephony/calls/answer
Answer
https://webexapis.com/v1/telephony/calls/answer
POSTAnswer
POSThttps://webexapis.com/v1/telephony/calls/reject
Reject
https://webexapis.com/v1/telephony/calls/reject
POSTReject
POSThttps://webexapis.com/v1/telephony/calls/hangup
Hangup
https://webexapis.com/v1/telephony/calls/hangup
POSTHangup
POSThttps://webexapis.com/v1/telephony/calls/hold
Hold
https://webexapis.com/v1/telephony/calls/hold
POSTHold
POSThttps://webexapis.com/v1/telephony/calls/resume
Resume
https://webexapis.com/v1/telephony/calls/resume
POSTResume
POSThttps://webexapis.com/v1/telephony/calls/mute
Mute
https://webexapis.com/v1/telephony/calls/mute
POSTMute
POSThttps://webexapis.com/v1/telephony/calls/unmute
Unmute
https://webexapis.com/v1/telephony/calls/unmute
POSTUnmute
POSThttps://webexapis.com/v1/telephony/calls/divert
Divert
https://webexapis.com/v1/telephony/calls/divert
POSTDivert
POSThttps://webexapis.com/v1/telephony/calls/transfer
Transfer
https://webexapis.com/v1/telephony/calls/transfer
POSTTransfer
POSThttps://webexapis.com/v1/telephony/calls/park
Park
https://webexapis.com/v1/telephony/calls/park
POSTPark
POSThttps://webexapis.com/v1/telephony/calls/retrieve
Retrieve
https://webexapis.com/v1/telephony/calls/retrieve
POSTRetrieve
POSThttps://webexapis.com/v1/telephony/calls/startRecording
Start Recording
https://webexapis.com/v1/telephony/calls/startRecording
POSTStart Recording
POSThttps://webexapis.com/v1/telephony/calls/stopRecording
Stop Recording
https://webexapis.com/v1/telephony/calls/stopRecording
POSTStop Recording
POSThttps://webexapis.com/v1/telephony/calls/pauseRecording
Pause Recording
https://webexapis.com/v1/telephony/calls/pauseRecording
POSTPause Recording
POSThttps://webexapis.com/v1/telephony/calls/resumeRecording
Resume Recording
https://webexapis.com/v1/telephony/calls/resumeRecording
POSTResume Recording
POSThttps://webexapis.com/v1/telephony/calls/transmitDtmf
Transmit DTMF
https://webexapis.com/v1/telephony/calls/transmitDtmf
POSTTransmit DTMF
POSThttps://webexapis.com/v1/telephony/calls/push
Push
https://webexapis.com/v1/telephony/calls/push
POSTPush
POSThttps://webexapis.com/v1/telephony/calls/pickup
Pickup
https://webexapis.com/v1/telephony/calls/pickup
POSTPickup
POSThttps://webexapis.com/v1/telephony/calls/bargeIn
Barge In
https://webexapis.com/v1/telephony/calls/bargeIn
POSTBarge In
GEThttps://webexapis.com/v1/telephony/calls
List Calls
https://webexapis.com/v1/telephony/calls
GETList Calls
GEThttps://webexapis.com/v1/telephony/calls/{callId}
Get Call Details
https://webexapis.com/v1/telephony/calls/{callId}
GETGet Call Details
GEThttps://webexapis.com/v1/telephony/calls/history
List Call History
https://webexapis.com/v1/telephony/calls/history
GETList Call History

Connect

Support

Developer Community

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2025 Cisco and/or its affiliates. All rights reserved.