# Dialpad — how to use (mcp.ai)

Dialpad is a cloud-based business phone system and contact center platform that enables voice, video, messages and meetings across your existing devices

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dialpad?ms=1781542080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dialpad_access_control_policies_listing`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dialpad`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dialpad/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/dialpad/access/control/policies/listing` — Retrieves a list of access control policies for the authenticated dialpad company. this endpoint allows company administrators to view all custom sets of permissions defined for ai contact center sett
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/add/blocked/phone/numbers` — Adds specified phone numbers to the blocked list in dialpad. this endpoint allows users to block unwanted or spam numbers, preventing incoming calls or messages from these numbers. it accepts a list o
  - body: { numbers?: string[] }
- `POST https://api.mcp.ai/api/dialpad/add/department/operator/by/id` — Adds a new operator to a specific department in dialpad. this endpoint allows you to assign either a user or a room as an operator, with the option to specify their role. it's used to manage call hand
  - body: { id: integer, role?: string, operator_id: integer, operator_type: string }
- `POST https://api.mcp.ai/api/dialpad/add/member/to/channel` — Adds a new member to a specified channel within the dialpad communication platform. this endpoint allows you to expand the membership of a channel by providing the user id of the person you want to ad
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/dialpad/add/member/to/coaching/team` — Adds a new member to a specific coaching team in dialpad. this endpoint allows you to assign a user to a coaching team with a designated role, enabling effective team management and performance monito
  - body: { id: integer, role: string, member_id: string }
- `POST https://api.mcp.ai/api/dialpad/add/operator/to/call/center` — This endpoint adds a new operator to a specified call center in the dialpad system. it allows for the configuration of the operator's role, skill level, and license type, as well as managing phone num
  - body: { id: integer, role?: string, user_id: integer, skill_level?: integer, license_type?: string, keep_paid_numbers?: boolean }
- `POST https://api.mcp.ai/api/dialpad/add/operator/to/office` — This endpoint adds a new operator to a specific office within the dialpad system. it allows administrators to assign users or rooms as operators, enhancing the office's communication capabilities. the
  - body: { id: integer, role?: string, operator_id: integer, operator_type: string }
- `POST https://api.mcp.ai/api/dialpad/add/participant/to/call` — Adds a new participant to an existing call in the dialpad system. this endpoint allows you to include additional members in an ongoing call by specifying either a phone number or a target within your 
  - body: { id: integer, participant: object }
- `POST https://api.mcp.ai/api/dialpad/assign/fax/line/to/target` — Creates and assigns a new fax line to a specified target (user or department) in the dialpad system. this endpoint allows you to set up a fax line with various options, including reserved numbers, are
  - body: { line: object, target__target__id?: integer, target__target__type?: string }
- `POST https://api.mcp.ai/api/dialpad/assign/number/to/call/router` — This endpoint assigns a phone number to a specific call router in the dialpad system. it allows users to either provide a full phone number for assignment or specify an area code to automatically sele
  - body: { id: integer, number?: string, primary?: boolean, area_code?: string }
- `POST https://api.mcp.ai/api/dialpad/assign/phone/number/to/office` — This endpoint assigns a phone number to a specific office in the dialpad system. it allows you to either specify a particular phone number or request an available number from a given area code. the as
  - body: { id: integer, number?: string, primary?: boolean, area_code?: string }
- `POST https://api.mcp.ai/api/dialpad/assign/phone/number/to/room` — Assigns a phone number to a specified room in dialpad. this endpoint allows you to either assign a specific phone number or request a number from a given area code. it's useful for setting up new room
  - body: { id: integer, number?: string, primary?: boolean, area_code?: string }
- `POST https://api.mcp.ai/api/dialpad/assign/phone/number/to/target` — Assigns a phone number to a specified target within the dialpad system. this endpoint allows you to either assign a specific number or request a number from a given area code. it can be used to add ne
  - body: { number?: string, primary?: boolean, area_code?: string, target_id: integer, target_type: string }
- `POST https://api.mcp.ai/api/dialpad/assign/phone/number/to/user` — This endpoint assigns a phone number to a specific dialpad user. it allows for either searching for an available number within a given area code or assigning a specific number to the user. the assigne
  - body: { id: integer, number?: string, primary?: boolean, area_code?: string }
- `POST https://api.mcp.ai/api/dialpad/assign/policy/to/user/by/id` — Assigns an access control policy to a specific user within the dialpad system. this endpoint allows administrators to grant customized settings permissions to users at various levels of the organizati
  - body: { id: integer, user_id: integer, target_id?: integer, target_type?: string }
- `POST https://api.mcp.ai/api/dialpad/attach/labels/to/call` — Creates or updates labels for a specific call in the dialpad system. this endpoint allows you to attach one or more labels to a call, which can be used for categorization, filtering, or tracking purpo
  - body: { id: integer, labels?: string[] }
- `POST https://api.mcp.ai/api/dialpad/configure/call/center/settings` — This endpoint creates a new call center within the dialpad system with customizable settings for call handling, routing, operational hours, and advanced features. it allows for detailed configuration 
  - body: { name: string, hours_on?: boolean, office_id: integer, friday_hours?: string[], monday_hours?: string[], ring_seconds?: integer, sunday_hours?: string[], tuesday_hours?: string[], saturday_hours?: string[], thursday_hours?: string[], wednesday_hours?: string[], group_description?: string, alerts__cc__service__level?: integer, routing__options__open__dtmf?: object[], hold__queue__max__hold__count?: integer, hold__queue__unattended__queue?: boolean, routing__options__closed__dtmf?: object[], routing__options__open__action?: string, hold__queue__announce__position?: boolean, hold__queue__max__hold__seconds?: integer, hold__queue__queue__escape__dtmf?: string, routing__options__closed__action?: string, voice__intelligence__auto__start?: boolean, voice__intelligence__allow__pause?: boolean, hold__queue__queue__callback__dtmf?: string, alerts__cc__service__level__seconds?: integer, hold__queue__allow__queue__callback?: boolean, hold__queue__queue__callback__threshold?: integer, routing__options__open__operator__routing?: string, advanced__settings__max__wrap__up__seconds?: integer, routing__options__open__action__target__id?: integer, routing__options__closed__operator__routing?: string, hold__queue__announcement__interval__seconds?: integer, hold__queue__stay__in__queue__after__closing?: boolean, routing__options__closed__action__target__id?: integer, routing__options__open__action__target__type?: string, routing__options__open__try__dial__operators?: boolean, routing__options__closed__action__target__type?: string, routing__options__closed__try__dial__operators?: boolean, advanced__settings__auto__call__recording__allow__pause__recording?: boolean, advanced__settings__auto__call__recording__call__recording__inbound?: boolean, advanced__settings__auto__call__recording__call__recording__outbound?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/access/control/policy` — Creates a new access control policy in dialpad, defining a set of permissions and their application scope. this endpoint allows administrators to establish granular control over various dialpad featur
  - body: { name: string, owner_id: integer, description?: string, target_type?: string, permission_sets: string[] }
- `POST https://api.mcp.ai/api/dialpad/create/agent/status/subscription` — Creates or updates an agent status subscription for real-time monitoring of contact center agent statuses in dialpad. this endpoint allows you to configure event notifications for changes in agent ava
  - body: { enabled?: boolean, agent_type: string, endpoint_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/create/call/review/share/link` — Creates a shareable link for a specific call review in the dialpad platform. this endpoint allows users to generate a url that can be used to share call recordings or summaries with others, either wit
  - body: { call_id?: integer, privacy?: string }
- `POST https://api.mcp.ai/api/dialpad/create/call/router/configuration` — Creates a new call router in the dialpad system, allowing for custom call routing logic based on a specified url. this endpoint configures essential settings for the call router, including its name, d
  - body: { name: string, secret?: string, enabled?: boolean, office_id: integer, routing_url: string, default_target_id: integer, default_target_type: string }
- `POST https://api.mcp.ai/api/dialpad/create/callback` — Creates a callback request in a dialpad call center. this endpoint allows you to initiate a callback to a specified phone number through a designated call center. it's useful for implementing features
  - body: { phone_number?: string, call_center_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/create/channel/endpoint` — Creates a new communication channel within the dialpad platform. this endpoint allows users to set up a dedicated space for team collaboration, discussions, or topic-specific conversations. it's parti
  - body: { name: string, user_id?: integer, description: string, privacy_type: string }
- `POST https://api.mcp.ai/api/dialpad/create/custom/ivr/with/audio/file` — Creates a new custom interactive voice response (ivr) system within the dialpad platform. this endpoint allows you to define and configure an ivr workflow by specifying its type, associated audio file
  - body: { file: string, name?: string, ivr_type: string, target_id: integer, description?: string, target_type: string }
- `POST https://api.mcp.ai/api/dialpad/create/new/contact/entry` — The createcontact endpoint adds a new contact to dialpad's system. use it to create local or shared contacts with comprehensive information. ideal for user onboarding, data migration, or system integr
  - body: { urls?: string[], emails?: string[], phones?: string[], owner_id?: string, extension?: string, job_title?: string, last_name: string, first_name: string, trunk_group?: string, company_name?: string }
- `POST https://api.mcp.ai/api/dialpad/create/new/department/record` — Creates a new department within the dialpad system with customizable settings for call handling, operating hours, and advanced features. this endpoint allows for detailed configuration of department p
  - body: { name: string, hours_on?: boolean, office_id: integer, friday_hours?: string[], monday_hours?: string[], ring_seconds?: integer, sunday_hours?: string[], tuesday_hours?: string[], saturday_hours?: string[], thursday_hours?: string[], wednesday_hours?: string[], group_description?: string, auto_call_recording?: boolean, hold__queue__allow__queuing?: boolean, routing__options__open__dtmf?: object[], hold__queue__max__hold__count?: integer, routing__options__closed__dtmf?: object[], routing__options__open__action?: string, hold__queue__max__hold__seconds?: integer, routing__options__closed__action?: string, voice__intelligence__auto__start?: boolean, voice__intelligence__allow__pause?: boolean, routing__options__open__operator__routing?: string, routing__options__open__action__target__id?: integer, routing__options__closed__operator__routing?: string, routing__options__closed__action__target__id?: integer, routing__options__open__action__target__type?: string, routing__options__open__try__dial__operators?: boolean, routing__options__closed__action__target__type?: string, routing__options__closed__try__dial__operators?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/pin/for/international/room/calls` — Creates a pin for protected international calls from a dialpad room. this endpoint generates a unique pin that can be used to authenticate and authorize international calls made from a specific dialpa
  - body: { customer_ref?: string }
- `POST https://api.mcp.ai/api/dialpad/create/room/in/office/via/post` — Creates a new room within a specified office in the dialpad system. this endpoint is used to set up physical or virtual spaces for collaboration, meetings, or other communication purposes. it allows y
  - body: { name: string, office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/create/schedule/reports/endpoint` — Creates a scheduled report in the dialpad system for various types of communication data. this endpoint allows users to automate the generation and delivery of reports on a regular basis, such as call
  - body: { at: integer, name: string, on_day: integer, enabled?: boolean, timezone?: string, frequency: string, target_id?: integer, endpoint_id: integer, report_type: string, target_type?: string, coaching_group?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/secondary/office` — Creates a new office within the dialpad system with specified configurations and settings. this endpoint allows you to set up a new office location or entity, including its billing information, operat
  - body: { name: string, country: string, currency: string, hours_on?: boolean, invoiced: boolean, timezone?: string, plan_period: string, first_action?: string, friday_hours?: string[], monday_hours?: string[], ring_seconds?: integer, sunday_hours?: string[], tuesday_hours?: string[], saturday_hours?: string[], thursday_hours?: string[], mainline_number?: string, unified_billing: boolean, wednesday_hours?: string[], use_same_address?: boolean, group_description?: string, e911__address__zip?: string, auto_call_recording?: boolean, e911__address__city?: string, no_operators_action?: string, e911__address__state?: string, international_enabled?: boolean, billing__address__city?: string, billing__contact__name?: string, e911__address__address?: string, e911__address__country?: string, billing__contact__email?: string, billing__contact__phone?: string, e911__address__address2?: string, billing__address__region?: string, billing__address__country?: string, routing__options__open__dtmf?: object[], annual_commit_monthly_billing: boolean, billing__address__postal__code?: string, routing__options__closed__dtmf?: object[], routing__options__open__action?: string, routing__options__closed__action?: string, voice__intelligence__auto__start?: boolean, voice__intelligence__allow__pause?: boolean, billing__address__address__line__1?: string, billing__address__address__line__2?: string, routing__options__open__operator__routing?: string, routing__options__open__action__target__id?: integer, routing__options__closed__operator__routing?: string, routing__options__closed__action__target__id?: integer, routing__options__open__action__target__type?: string, routing__options__open__try__dial__operators?: boolean, routing__options__closed__action__target__type?: string, routing__options__closed__try__dial__operators?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/sms/event/subscription` — Creates a new sms event subscription in the dialpad api, allowing users to receive notifications for inbound and/or outbound sms messages. this endpoint enables fine-grained control over sms event mon
  - body: { status?: boolean, enabled?: boolean, direction: string, target_id?: integer, endpoint_id?: integer, target_type?: string, include_internal?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/user/with/auto/assign` — Creates a new user account in the dialpad system with the specified details. this endpoint allows you to add a new user to your dialpad organization, set up their basic profile information, assign the
  - body: { email: string, license?: string, last_name?: string, office_id: integer, first_name?: string, auto_assign?: boolean }
- `POST https://api.mcp.ai/api/dialpad/create/webhook/post/endpoint` — Creates a new webhook integration for receiving real-time event notifications from dialpad. this endpoint allows you to specify a url where dialpad will send event data when specific actions occur wit
  - body: { secret?: string, hook_url: string }
- `POST https://api.mcp.ai/api/dialpad/deauthorize/oauth2/session` — Deauthorizes (revokes) an oauth2 access token, effectively terminating the application's access to the dialpad api. this endpoint should be used when an application needs to invalidate its current acc
- `POST https://api.mcp.ai/api/dialpad/delete/access/control/policy/by/id` — Deletes a specific access control policy from the dialpad system. this endpoint allows company administrators to remove custom permission settings that were previously created for managing user roles 
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/agent/status/by/id` — Deletes a specific agent status subscription identified by its unique id. this endpoint is used to stop receiving real-time updates about an agent's status (e.g., available, busy, off-duty) in the dia
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/call/center/by/id` — Deletes a specific call center from the dialpad system. this endpoint should be used when you need to permanently remove a call center from your dialpad account. it's important to note that this actio
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/call/review/share/link/by/id` — This endpoint deletes a specific call review share link in the dialpad system. it's used to revoke access to a previously shared call review, ensuring that the link can no longer be used to view the a
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/delete/call/router/by/id` — Deletes a specific call router from the dialpad system. this endpoint should be used when you need to remove an existing call routing configuration, such as when restructuring your call flow or decomm
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/delete/call/subscription/by/id` — Deletes a specific call subscription from the dialpad system. this endpoint should be used when an application no longer needs to receive real-time notifications for a particular call-related event or
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/channel/by/id` — Deletes a specific channel from the dialpad communication platform. this endpoint should be used when you need to remove a communication channel that is no longer needed or has become obsolete. it per
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/channel/member/by/id` — Removes a specified member from a dialpad channel. this endpoint allows you to delete a user from a particular channel, effectively revoking their access and participation in that channel's communicat
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/contact/by/id` — Deletes a specific contact from the dialpad system using the provided contact id. this endpoint should be used when you need to permanently remove a contact's information from your dialpad account. it
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/delete/custom/ivr/by/target/type/and/ivrtype` — Deletes a custom interactive voice response (ivr) configuration from a specified target in the dialpad system. this endpoint is used to remove ivr settings, allowing for the reset or reconfiguration o
  - body: { ivr_id: integer, ivr_type: string, target_id: integer, target_type: string, select_option?: string }
- `POST https://api.mcp.ai/api/dialpad/delete/department/resource` — Deletes a specific department from the dialpad system. this endpoint should be used when you need to remove a department that is no longer needed or has been deprecated within your organization's stru
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/deskphone/by/user/id` — Deletes a specific deskphone associated with a user in the dialpad system. this endpoint should be used when you need to remove a deskphone from a user's account, such as when the device is no longer 
  - body: { id: string, parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/deskphone/in/room` — This endpoint removes a specific deskphone from a designated room within the dialpad system. it's used to unassign or decommission a deskphone from a particular shared space, such as a conference room
  - body: { id: string, parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/number/via/api` — Deletes a specific phone number from the user's dialpad account. this endpoint should be used when a phone number is no longer needed and needs to be removed from the system. it's important to note th
  - body: { number: string, release?: boolean }
- `POST https://api.mcp.ai/api/dialpad/delete/office/operator/by/id` — Removes a specified operator (user or room) from a particular office in the dialpad system. this endpoint is used to manage the association between operators and offices, allowing administrators to co
  - body: { id: integer, operator_id: integer, operator_type: string }
- `POST https://api.mcp.ai/api/dialpad/delete/operator/from/call/center` — Removes a specified operator from a call center in the dialpad system. this endpoint should be used when you need to disassociate an agent or user from a particular call center, such as when an employ
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/operator/from/department` — Removes a specified operator from a department in the dialpad system. this endpoint is used to update department operator assignments by removing either a user or a room from the list of operators for
  - body: { id: integer, operator_id: integer, operator_type: string }
- `POST https://api.mcp.ai/api/dialpad/delete/recording/share/link/by/id` — Deletes a specific recording share link in the dialpad system. this endpoint is used to revoke access to a shared recording by removing the associated link. it should be called when you want to preven
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/delete/room/by/id` — Deletes a specific room from the dialpad system using its unique identifier. this endpoint should be used when you need to remove a room that is no longer in use or has been decommissioned, such as a 
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/schedule/report/by/id` — Deletes a specific scheduled report from the dialpad system. this endpoint allows users to permanently remove a previously configured report that was set up for automatic generation and delivery. it s
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/sms/subscription/by/id` — Deletes a specific sms subscription from the dialpad system. this endpoint should be used when you want to cancel or remove an existing sms subscription, such as when a user no longer needs sms servic
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/subscription/changelog/by/id` — Deletes a specific changelog entry from a subscription in the dialpad system. this endpoint is used to permanently remove a record of changes made to a subscription, which could include modifications 
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/subscription/contact/by/id` — Deletes a specific subscription contact from the dialpad system. this endpoint should be used when you need to remove a contact from your subscription list, such as when a user unsubscribes or when cl
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/user/by/id` — Deletes a user from the dialpad system based on the provided user id. this endpoint should be used when permanently removing a user's account and associated data from dialpad. it's important to note t
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/delete/webhook/by/id` — Deletes a specific webhook subscription from the dialpad platform using its unique identifier. this endpoint should be used when you want to stop receiving real-time event notifications for a particul
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/delete/websocket/connection/by/id` — Closes and removes a specific websocket connection in the dialpad system. this endpoint should be used when an application needs to programmatically terminate a real-time event subscription or clean u
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/fetch/call/by/id` — Retrieves detailed information about a specific call using its unique identifier. this endpoint allows developers to access comprehensive data about a particular call made through the dialpad platform
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/fetch/call/transcript/by/id` — Retrieves the transcript for a specific call in the dialpad system. this endpoint allows you to fetch the text representation of the spoken content from a particular call or meeting. it's useful for r
  - body: { call_id: integer }
- `POST https://api.mcp.ai/api/dialpad/fetch/custom/ivrs` — Retrieves a list of all custom interactive voice response (ivr) configurations associated with the authenticated dialpad account. this endpoint allows developers to fetch comprehensive details about t
  - body: { cursor?: string, target_id: integer, target_type: string }
- `POST https://api.mcp.ai/api/dialpad/fetch/operators/for/office/id` — Retrieves a list of operators associated with a specific office in dialpad. this endpoint should be used when you need to get information about the operators managing calls and operations within a par
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/fetch/scheduled/reports` — Retrieves a list of scheduled reports from the dialpad system. this endpoint allows users to fetch information about reports that have been set up for automatic generation on a regular basis. it's par
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/fetch/transcript/url/by/call/id` — Retrieves the url of a transcript for a specific call in the dialpad system. this endpoint allows developers to access the text version of a call's audio content by providing the unique identifier of 
  - body: { call_id: integer }
- `POST https://api.mcp.ai/api/dialpad/fetch/user/details/by/id` — Retrieves detailed information about a specific user in the dialpad system. this endpoint is used to fetch comprehensive user data, including profile details, account settings, and associated communic
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/format/phone/numbers` — The format phone number endpoint is used to standardize and format phone numbers within the dialpad ecosystem. this tool takes a raw phone number input and converts it into a specified or default form
  - body: { number?: string, country_code?: string }
- `POST https://api.mcp.ai/api/dialpad/get/available/licenses/for/an/office` — Retrieves the number of available (unused) licenses for a specific office within a dialpad organization. this endpoint is used to check the current license capacity and availability before assigning n
  - body: { office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/call/center/status/by/id` — Retrieves the current operational status of a specific call center in the dialpad system. this endpoint allows you to get real-time information about a call center's state, which can include details s
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/call/labels` — Retrieves a list of all available call labels in the dialpad system. this endpoint allows users to fetch the current set of labels that can be applied to calls for categorization and management purpos
  - body: { limit?: integer }
- `POST https://api.mcp.ai/api/dialpad/get/call/review/share/link/by/id` — Retrieves or generates a share link for a specific call review in the dialpad system. this endpoint allows users to obtain a unique url that can be used to share call review data, including summaries,
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/get/call/subscription/details` — Retrieves a list of call subscriptions associated with the authenticated user's account in the dialpad platform. this endpoint allows developers to fetch details about existing call event subscription
  - body: { cursor?: string, target_id?: integer, target_type?: string }
- `POST https://api.mcp.ai/api/dialpad/get/channel/members/by/id` — Retrieves a list of members for a specific channel in dialpad. this endpoint allows you to fetch user information for all members associated with the given channel id. it's useful for obtaining an ove
  - body: { id: integer, cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/get/departments/by/office/id` — Retrieves a list of all departments associated with a specific office in the dialpad system. this endpoint is essential for understanding the organizational structure within a company's dialpad accoun
  - body: { cursor?: string, office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/deskphone/by/parent/id` — Retrieves detailed information about a specific deskphone within a designated room or parent entity in the dialpad system. this endpoint is useful for obtaining the current configuration, status, and 
  - body: { id: string, parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/deskphones/for/user/parent/id` — Retrieves a list of deskphones associated with a specific user in the dialpad system. this endpoint is useful for managing and tracking the deskphone inventory assigned to individual users within an o
  - body: { parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/deskphones/in/rooms` — Retrieves a list of deskphones associated with a specific room in the dialpad system. this endpoint is used to get detailed information about the communication devices deployed in shared spaces such a
  - body: { parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/office/call/centers` — Retrieves a list of call centers associated with a specific office in the dialpad platform. this endpoint allows administrators and developers to fetch information about all call centers within a give
  - body: { cursor?: string, office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/operator/skills/by/call/center/and/user` — Retrieves the skill information for a specific operator within a designated call center. this endpoint allows you to access details about an operator's assigned skills, which are crucial for efficient
  - body: { user_id: integer, call_center_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/phone/number/details` — Retrieves detailed information about a specific phone number associated with the dialpad account. this endpoint allows you to fetch comprehensive data about a single phone number, including its curren
  - body: { number: string }
- `POST https://api.mcp.ai/api/dialpad/get/recording/share/link/by/id` — Retrieves detailed information about a specific recording share link in the dialpad system. this endpoint allows you to fetch the current status, settings, and metadata associated with a previously cr
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/get/rooms/list` — Retrieves a list of all available meeting rooms or spaces within the dialpad system. this endpoint is essential for managing and organizing video-enabled meetings, allowing users to view and select ap
  - body: { cursor?: string, office_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/get/subscription/contact/by/id` — Retrieves the subscription information for a specific contact in the dialpad system. this endpoint allows you to access details about a contact's current subscription status, type, and related informa
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/user/caller/id` — Retrieves the caller id information for a specific user in the dialpad system. this endpoint allows you to fetch the current caller id settings associated with a user's account, which may include thei
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/get/user/deskphones` — Retrieves detailed information about a specific deskphone associated with a particular user in the dialpad system. this endpoint is useful when you need to access or verify the configuration, status, 
  - body: { id: string, parent_id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/user/e911/details` — Retrieves the enhanced 911 (e911) information for a specific user in the dialpad system. this endpoint provides critical location data associated with the user's account, which is essential for emerge
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/get/webhooks/information` — Retrieves a list of all webhooks configured for the authenticated user's dialpad account. this endpoint allows developers to view and manage their existing webhook subscriptions for various communicat
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/hangup/call/via/id` — Terminates an active call in the dialpad system. this endpoint should be used when you need to programmatically end a specific ongoing call. it's particularly useful for automated call management, suc
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/initiate/ivr/call/api/endpoint` — Initiates an outbound ivr (interactive voice response) call using the dialpad api. this endpoint allows you to programmatically start a call to a specified phone number from a designated group within 
  - body: { target_id: integer, custom_data?: string, target_type: string, phone_number: string, outbound_caller_id?: string }
- `POST https://api.mcp.ai/api/dialpad/initiate/outbound/call/via/api` — The initiateoutboundcall endpoint allows you to programmatically initiate an outbound call using the dialpad api. this tool is used to place calls on behalf of a dialpad user to a specified phone numb
  - body: { user_id: integer, group_id?: integer, device_id?: string, group_type?: string, is_consult?: boolean, custom_data?: string, phone_number: string, outbound_caller_id?: string }
- `POST https://api.mcp.ai/api/dialpad/initiate/user/call/with/group/options` — Initiates an outbound call for a specified dialpad user. this endpoint allows you to programmatically start a phone call to a given number, with options to customize the call's properties such as the 
  - body: { id: string, group_id?: integer, group_type?: string, custom_data?: string, phone_number?: string, outbound_caller_id?: string }
- `POST https://api.mcp.ai/api/dialpad/list/channels/api` — Retrieves a list of all available communication channels in the dialpad platform. this endpoint provides an overview of the various channels that can be used for voice, sms, and other digital engageme
  - body: { state?: string, cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/list/conference/rooms` — Retrieves a list of conference rooms available in the dialpad system. this endpoint allows users to fetch information about both virtual and physical conference rooms set up within their dialpad accou
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/list/offices/endpoint` — Retrieves a list of offices within the dialpad platform. this endpoint provides access to office information, which is crucial for managing multiple offices in an organization using dialpad. it should
  - body: { cursor?: string, active_only?: boolean }
- `POST https://api.mcp.ai/api/dialpad/list/users` — Retrieves a list of users from the dialpad system. this endpoint allows you to fetch user account information, which is essential for user management and provisioning tasks. it can be used to sync use
  - body: { email?: string, state?: string, cursor?: string, number?: string, company_admin?: boolean }
- `POST https://api.mcp.ai/api/dialpad/modify/contact/details/using/id` — Updates an existing contact's information in the dialpad system. this endpoint allows for partial updates of contact details, including personal information, communication details, and associated urls
  - body: { id: string, urls?: string[], emails?: string[], phones?: string[], extension?: string, job_title?: string, last_name?: string, first_name?: string, trunk_group?: string, company_name?: string }
- `POST https://api.mcp.ai/api/dialpad/modify/custom/ivr/settings` — Updates a custom interactive voice response (ivr) configuration for a specific target within the dialpad system. this endpoint allows you to assign an existing ivr workflow to a particular target (suc
  - body: { ivr_id: integer, ivr_type: string, target_id: integer, target_type: string, select_option?: string }
- `POST https://api.mcp.ai/api/dialpad/modify/operator/skill/level` — Updates the skill level of a specific operator in a designated call center. this endpoint allows administrators to adjust an operator's proficiency rating, which can be used for call routing, performa
  - body: { user_id: integer, skill_level: integer, call_center_id: integer }
- `POST https://api.mcp.ai/api/dialpad/modify/webhook/configuration` — Updates an existing webhook configuration in the dialpad api. this endpoint allows you to modify the destination url and/or the secret used for request validation of a specific webhook. use this when 
  - body: { id: string, secret?: string, hook_url?: string }
- `POST https://api.mcp.ai/api/dialpad/move/user/to/specified/office` — Updates a user's office assignment within the dialpad system. this endpoint allows administrators to move a user from their current office to a different office. it should be used when there's a need 
  - body: { id: string, office_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/oauth2/authorize/endpoint` — Initiates the oauth 2.0 authorization process for the dialpad api. this endpoint is the entry point for obtaining user consent and generating an authorization code, which can later be exchanged for an
  - body: { scope?: string, state?: string, client_id: string, redirect_uri: string, response_type?: string, code_challenge?: string, code_challenge_method?: string }
- `POST https://api.mcp.ai/api/dialpad/patch/access/control/policy/by/id` — This endpoint allows you to update an existing access control policy in the dialpad system. it provides the ability to modify various attributes of a policy, including its name, description, associate
  - body: { id: integer, name?: string, state?: string, user_id?: integer, description?: string, permission_sets?: string[] }
- `POST https://api.mcp.ai/api/dialpad/patch/agent/status/event/subscription` — Updates an existing agent status subscription in the dialpad system. this endpoint allows you to modify the configuration of a subscription that tracks changes in agent statuses within a contact cente
  - body: { id: string, enabled?: boolean, agent_type?: string, endpoint_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/patch/call/router/by/id` — Updates an existing call router in the dialpad system. this endpoint allows you to modify various settings of a call router, including its default target, enabled state, name, office association, erro
  - body: { id: string, name?: string, secret?: string, enabled?: boolean, office_id?: integer, routing_url?: string, default_target_id?: integer, reset_error_count?: boolean, default_target_type?: string }
- `POST https://api.mcp.ai/api/dialpad/patch/department/details/by/id` — Updates the settings and configuration of a specific department in the dialpad system. this endpoint allows for comprehensive modification of department properties, including operating hours, call rou
  - body: { id: integer, name?: string, hours_on?: boolean, friday_hours?: string[], monday_hours?: string[], ring_seconds?: integer, sunday_hours?: string[], tuesday_hours?: string[], saturday_hours?: string[], thursday_hours?: string[], wednesday_hours?: string[], group_description?: string, auto_call_recording?: boolean, hold__queue__allow__queuing?: boolean, routing__options__open__dtmf?: object[], hold__queue__max__hold__count?: integer, routing__options__closed__dtmf?: object[], routing__options__open__action?: string, hold__queue__max__hold__seconds?: integer, routing__options__closed__action?: string, voice__intelligence__auto__start?: boolean, voice__intelligence__allow__pause?: boolean, routing__options__open__operator__routing?: string, routing__options__open__action__target__id?: integer, routing__options__closed__operator__routing?: string, routing__options__closed__action__target__id?: integer, routing__options__open__action__target__type?: string, routing__options__open__try__dial__operators?: boolean, routing__options__closed__action__target__type?: string, routing__options__closed__try__dial__operators?: boolean }
- `POST https://api.mcp.ai/api/dialpad/patch/subscription/changelog/endpoint` — Updates an existing change log event subscription in the dialpad system. this endpoint allows you to modify the status of a subscription and associate it with a specific logging endpoint. use this whe
  - body: { id: string, enabled?: boolean, endpoint_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/patch/user/active/call/recording` — Updates the call recording settings for an active call of a specific dialpad user. this endpoint allows real-time management of call recording features during an ongoing call, including enabling or di
  - body: { id: integer, is_recording?: boolean, play_message?: boolean, recording_type?: string }
- `POST https://api.mcp.ai/api/dialpad/patch/user/status` — Updates the status of a specific user in the dialpad system. this endpoint allows you to set or modify a user's status message and optionally specify an expiration time for that status. it's particula
  - body: { id: integer, expiration?: integer, status_message?: string }
- `POST https://api.mcp.ai/api/dialpad/patch/websocket/signature/secret` — Updates the signature secret for a specific websocket connection in the dialpad platform. this endpoint allows you to modify the authentication mechanism used to validate incoming requests to the webs
  - body: { id: integer, secret?: string }
- `POST https://api.mcp.ai/api/dialpad/post/call/event/subscription` — Creates a new call event subscription in the dialpad system, allowing real-time notifications for various call states and actions. this endpoint enables developers to set up targeted event streams for
  - body: { enabled?: boolean, target_id?: integer, call_states?: string[], endpoint_id?: integer, target_type?: string, group_calls_only?: boolean }
- `POST https://api.mcp.ai/api/dialpad/post/recording/share/link` — Creates a shareable link for a specific recording in dialpad, such as a call recording or voicemail. this endpoint allows users to generate a link that can be used to share recordings with others, wit
  - body: { privacy?: string, recording_id: string, recording_type: string }
- `POST https://api.mcp.ai/api/dialpad/post/subscription/change/log/event` — Creates or updates a subscription for changelog events in the dialpad system. this endpoint allows developers to set up real-time notifications for changes and updates within dialpad, such as api modi
  - body: { enabled?: boolean, endpoint_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/post/users/screenpop/uri` — Triggers a screen pop for a specific dialpad user, displaying relevant information during a call or communication event. this endpoint should be used when you need to automatically present contextual 
  - body: { id: integer, screen_pop_uri: string }
- `POST https://api.mcp.ai/api/dialpad/post/websocket/connection/secret` — Creates a websocket connection for real-time communication with the dialpad platform. this endpoint enables applications to establish a persistent, full-duplex connection for receiving live updates an
  - body: { secret?: string }
- `POST https://api.mcp.ai/api/dialpad/reassign/phone/number/to/target` — Assigns or reassigns a phone number to a specific target within the dialpad system. this endpoint allows you to associate a phone number with various entities such as users, departments, call centers,
  - body: { number: string, primary?: boolean, target_id: integer, target_type: string }
- `POST https://api.mcp.ai/api/dialpad/redeem/access/or/refresh/token` — The oauth 2.0 token endpoint for dialpad's api is used to obtain access tokens for authenticating api requests. it supports two grant types: authorization code and refresh token. for the authorization
- `POST https://api.mcp.ai/api/dialpad/remove/blocked/numbers` — Removes specified phone numbers from the blocked list in the dialpad system. this endpoint allows you to unblock multiple phone numbers in a single api call, streamlining the process of managing block
  - body: { numbers?: string[] }
- `POST https://api.mcp.ai/api/dialpad/retrieve/access/control/policy/assignments` — Retrieves the assignments of a specific access control policy in dialpad. this endpoint allows company administrators to view which users, roles, or groups have been assigned to a particular access co
  - body: { id: integer, cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/access/control/policy/by/id` — Retrieves detailed information about a specific access control policy in the dialpad system. this endpoint allows administrators to fetch the configuration and settings of a particular policy, which d
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/agent/status/by/id` — Retrieves detailed information about a specific agent status subscription using its unique identifier. this endpoint is used to fetch the current configuration and settings of an agent status subscrip
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/agent/status/subscription` — Retrieves a list of agent status subscriptions from the dialpad system. this endpoint allows you to fetch real-time information about the current subscriptions to agent status events. it is useful for
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/app/settings` — Retrieves the current application settings for the authenticated dialpad account. this endpoint provides access to various configuration options and preferences set for the dialpad application. it sho
  - body: { target_id?: integer, target_type?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/blocked/number/details` — Retrieves information about a specific blocked number in the dialpad system. this endpoint allows users or administrators to check if a particular phone number is currently blocked. it's useful for ve
  - body: { number: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/blocked/phone/numbers` — Retrieves a comprehensive list of all phone numbers that have been blocked through the dialpad api. this endpoint is useful for managing call blocking settings and reviewing the current state of block
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/center/by/id` — Retrieves detailed information about a specific call center in the dialpad system. this endpoint allows you to fetch comprehensive data about a call center, including its configuration, associated age
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/centers/information` — Retrieves a list of call centers and their associated information from the dialpad platform. this endpoint allows developers to fetch details about all call centers configured in the dialpad account, 
  - body: { cursor?: string, office_id?: integer, name_search?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/information` — Retrieves call information from the dialpad system. this endpoint allows you to fetch details about one or more calls, which may include call duration, participants, timestamps, and other relevant met
  - body: { cursor?: string, target_id?: integer, target_type?: string, started_after?: integer, started_before?: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/router/by/id` — Retrieves detailed information about a specific call router in the dialpad system. this endpoint allows developers to fetch the configuration and status of a call router by providing its unique identi
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/routers/v2/api` — Retrieves a list of call routers configured in the dialpad system. this endpoint allows you to fetch information about the call routing setup in your dialpad account, including details such as router 
  - body: { cursor?: string, office_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/call/subscription/by/id` — Retrieves detailed information about a specific call subscription in the dialpad system. this endpoint allows developers to access the current state and configuration of a call subscription, which is 
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/callcenter/operators/by/id` — Retrieves a list of operators associated with a specific call center in dialpad. this endpoint allows you to fetch detailed information about the operators working in a particular call center, which i
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/channel/by/id` — Retrieves detailed information about a specific communication channel in the dialpad platform using its unique identifier. this endpoint allows developers to fetch comprehensive data about a particula
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/coaching/stats/v2` — The getstatistics endpoint retrieves comprehensive statistics for various aspects of dialpad usage, including calls, customer satisfaction (csat), dispositions, on-duty status, recordings, screen shar
  - body: { group_by?: string, is_today?: boolean, timezone?: string, office_id?: integer, stat_type: string, target_id?: integer, export_type: string, target_type?: string, days_ago_end?: integer, coaching_team?: boolean, coaching_group?: boolean, days_ago_start?: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/coaching/team/by/id` — Retrieves detailed information about a specific coaching team in dialpad. this endpoint allows users to fetch comprehensive data about a coaching team, including its configuration, members (coaches an
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/coaching/teams/information` — Retrieves information about coaching teams in the dialpad platform. this endpoint allows users to fetch details about existing coaching teams, which are essential for managing call monitoring, feedbac
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/company/data` — Retrieves detailed information about a specific company within the dialpad platform. this endpoint allows developers to access various company-level data, such as company name, settings, and other rel
- `POST https://api.mcp.ai/api/dialpad/retrieve/conference/meetings` — Retrieves information about conference meetings in the dialpad platform. this endpoint allows users to fetch details about scheduled, ongoing, or past conference meetings, providing valuable data for 
  - body: { cursor?: string, room_id?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/contact/by/id` — Retrieves detailed information for a specific contact in your dialpad account using the contact's unique identifier. this endpoint allows you to fetch comprehensive data about a single contact, includ
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/contact/list` — Retrieves a list of contacts from the dialpad platform. this endpoint allows you to fetch contact information, which is crucial for managing user data and communication records within your dialpad-int
  - body: { cursor?: string, owner_id?: string, include_local?: boolean }
- `POST https://api.mcp.ai/api/dialpad/retrieve/department/by/id` — Retrieves detailed information about a specific department within the dialpad organization. this endpoint allows you to fetch comprehensive data about a department, including its name, description, me
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/department/operators/by/id` — Retrieves a list of operators associated with a specific department in dialpad. this endpoint allows you to fetch detailed information about the operators assigned to a particular department, enabling
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/e911/office/details` — Retrieves the enhanced 911 (e911) settings for a specific office within the dialpad communication platform. this endpoint allows administrators to fetch crucial emergency service configuration details
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/list/of/departments` — Retrieves a list of departments for a specified office within the dialpad organization. this endpoint is essential for obtaining the organizational structure and can be used to populate department sel
  - body: { cursor?: string, office_id?: integer, name_search?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/members/of/coaching/team/by/id` — Retrieves a list of members belonging to a specific coaching team in dialpad. this endpoint allows you to fetch all users assigned to a particular coaching team, including both coaches and trainees. i
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/numbers/via/api/v2` — Retrieves a list of phone numbers associated with the user's dialpad account. this endpoint allows users to view all the phone numbers they have access to, which may include both assigned and unassign
  - body: { cursor?: string, status?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/off/duty/status/by/office/id` — Retrieves the list of custom off-duty statuses for a specific office within the dialpad system. this endpoint is used to fetch and manage the availability statuses of agents assigned to a particular o
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/office/by/id` — Retrieves detailed information about a specific office within the dialpad system. this endpoint should be used when you need to access comprehensive data about a particular office, such as its name, l
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/office/plan/by/id` — Retrieves the current plan details for a specific office in your dialpad organization. this endpoint allows you to fetch information about the subscribed features, limitations, and other plan-specific
  - body: { office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/operator/duty/status` — Retrieves the current duty status of a specific call center operator in dialpad. this endpoint allows you to check whether an operator is active (available to receive inbound calls) or off-duty (not a
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/room/information/by/id` — Retrieves detailed information about a specific room in the dialpad system. this endpoint allows you to fetch the current state, settings, and properties of a virtual collaboration space identified by
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/schedule/report/by/id` — Retrieves detailed information about a specific scheduled report in the dialpad system. this endpoint allows you to fetch the configuration and metadata of a pre-defined report, which may include comm
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/sms/opt/out/by/company/id` — Retrieves the sms opt-out list for a specific company within the dialpad platform. this endpoint allows you to fetch all phone numbers that have opted out of receiving sms messages from the specified 
  - body: { id: string, cursor?: string, opt_out_state: string, a2p_campaign_id?: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/sms/subscription/by/id` — Retrieves detailed information about a specific sms subscription in dialpad. this endpoint allows developers to fetch the current status, configuration, and other relevant details of an sms subscripti
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/sms/subscriptions` — Retrieves a list of sms subscriptions associated with the authenticated user's dialpad account. this endpoint allows users to view and manage their current sms subscription plans and settings. it shou
  - body: { cursor?: string, target_id?: integer, target_type?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/specific/webhook/by/id` — Retrieves detailed information about a specific webhook configuration in the dialpad system. this endpoint allows developers to fetch the current status, settings, and event subscriptions for a partic
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/stat/by/id` — Retrieves detailed statistics and analytics data for a specific entity within the dialpad platform. this endpoint allows you to access performance metrics, communication data, and other relevant stati
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/subscription/change/log` — Retrieves the changelog for dialpad api subscriptions. this endpoint provides a historical record of changes and updates made to subscription events and notifications within the dialpad system. it's u
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/subscription/change/log/by/id` — Retrieves the changelog for a specific subscription in the dialpad system. this endpoint allows you to access a historical record of changes made to a particular subscription, including updates, modif
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/subscription/contacts` — Retrieves subscription information for contacts in the dialpad system. this endpoint allows you to fetch details about contact event subscriptions, which are crucial for receiving real-time notificati
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/teams/for/office/id` — Retrieves a list of teams associated with a specific office in the dialpad organization. this endpoint is useful for getting an overview of the team structure within a particular office, which can be 
  - body: { cursor?: string, office_id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/user/device/by/id` — Retrieves detailed information about a specific user device associated with a dialpad account. this endpoint allows developers to fetch the current state and configuration of a particular device by pr
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/user/devices/list` — Retrieves a list of devices associated with users in the dialpad system. this endpoint allows you to fetch information about various communication devices used within your dialpad organization, such a
  - body: { cursor?: string, user_id?: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/user/personas/by/id` — Retrieves all personas associated with a specific user in the dialpad system. this endpoint allows you to fetch the various identities or roles that a user can assume when making calls, providing deta
  - body: { id: string }
- `POST https://api.mcp.ai/api/dialpad/retrieve/websocket/by/id` — Retrieves detailed information about a specific websocket connection using its unique identifier. this endpoint allows developers to query the status, metadata, and other relevant details of an active
  - body: { id: integer }
- `POST https://api.mcp.ai/api/dialpad/retrieve/websocket/connection` — Retrieves information about websocket connections or initiates a websocket connection for real-time event subscriptions with dialpad. this endpoint is essential for applications that require live upda
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/dialpad/send/sms/with/optional/media/and/group/sender` — The sendsms endpoint allows you to send sms or mms messages through the dialpad platform to one or multiple recipients. this versatile tool supports various sender identification methods, group messag
  - body: { text?: string, media?: string, user_id?: integer, to_numbers?: string[], from_number?: string, channel_hashtag?: string, sender_group_id?: integer, sender_group_type?: string, infer_country_code?: boolean }
- `POST https://api.mcp.ai/api/dialpad/set/user/caller/id/by/id` — Sets or blocks the caller id for a specific dialpad user. this endpoint allows you to define the phone number that will be displayed when the user makes outgoing calls, or to block the caller id entir
  - body: { id: string, caller_id: string }
- `POST https://api.mcp.ai/api/dialpad/subscribe/contact/event` — Creates a new contact event subscription in the dialpad platform, allowing you to receive real-time updates about changes to contacts. this endpoint enables you to subscribe to events for either local
  - body: { enabled?: boolean, endpoint_id?: integer, contact_type: string }
- `POST https://api.mcp.ai/api/dialpad/toggle/user/do/not/disturb/status` — The toggleuserdonotdisturb endpoint allows you to update the do not disturb (dnd) status for a specific user in the dialpad system. this powerful feature enables programmatic control over a user's ava
  - body: { id: string, group_id?: integer, group_type?: string, do_not_disturb: boolean }
- `POST https://api.mcp.ai/api/dialpad/toggle/vi/call/for/user/by/id` — Toggles the voice intelligence (vi) feature for a specific dialpad user. this endpoint allows administrators to enable or disable vi capabilities for individual users, which includes features like rea
  - body: { id: integer, enable_vi?: boolean }
- `POST https://api.mcp.ai/api/dialpad/transfer/call/to/destination` — Transfers an active call within the dialpad system to a new destination. this endpoint allows for flexible call routing by enabling transfers to another ongoing call, a specific phone number, or a pre
  - body: { id: integer, to?: object, custom_data?: string, transfer_state?: string }
- `POST https://api.mcp.ai/api/dialpad/unassign/access/control/policy/from/user` — This endpoint unassigns a user from a specific access control policy in dialpad. it allows for granular control over policy assignments by supporting unassignment at different target levels (company, 
  - body: { id: integer, user_id: integer, target_id?: integer, target_type?: string, unassign_all?: boolean }
- `POST https://api.mcp.ai/api/dialpad/unassign/office/number` — This endpoint unassigns a specific phone number from a dialpad office. it is used to remove the association between a phone number and an office, which can be helpful for reorganizing phone number all
  - body: { id: integer, number: string }
- `POST https://api.mcp.ai/api/dialpad/unassign/room/phone/number` — This endpoint unassigns a phone number from a specific room in the dialpad system. it allows you to remove a previously assigned phone number from a room, freeing it up for potential reassignment or t
  - body: { id: integer, number: string }
- `POST https://api.mcp.ai/api/dialpad/unassign/user/phone/number` — Unassigns a specified phone number from a user's dialpad account. this endpoint should be used when you need to remove a phone number association from a particular user, such as when an employee chang
  - body: { id: integer, number: string }
- `POST https://api.mcp.ai/api/dialpad/unpark/call/by/user/id` — Unparks a previously parked call in the dialpad system. this endpoint allows you to retrieve a call that was temporarily placed on hold (parked) and assign it to a specific user for handling. it's par
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/dialpad/update/call/center/settings/by/id` — Updates the configuration of an existing call center in the dialpad platform. this endpoint allows for comprehensive modifications to call center settings, including operational hours, routing strateg
  - body: { id: integer, name?: string, hours_on?: boolean, friday_hours?: string[], monday_hours?: string[], ring_seconds?: integer, sunday_hours?: string[], tuesday_hours?: string[], saturday_hours?: string[], thursday_hours?: string[], wednesday_hours?: string[], group_description?: string, alerts__cc__service__level?: integer, routing__options__open__dtmf?: object[], hold__queue__max__hold__count?: integer, hold__queue__unattended__queue?: boolean, routing__options__closed__dtmf?: object[], routing__options__open__action?: string, hold__queue__announce__position?: boolean, hold__queue__max__hold__seconds?: integer, hold__queue__queue__escape__dtmf?: string, routing__options__closed__action?: string, voice__intelligence__auto__start?: boolean, voice__intelligence__allow__pause?: boolean, hold__queue__queue__callback__dtmf?: string, alerts__cc__service__level__seconds?: integer, hold__queue__allow__queue__callback?: boolean, hold__queue__queue__callback__threshold?: integer, routing__options__open__operator__routing?: string, advanced__settings__max__wrap__up__seconds?: integer, routing__options__open__action__target__id?: integer, routing__options__closed__operator__routing?: string, hold__queue__announcement__interval__seconds?: integer, hold__queue__stay__in__queue__after__closing?: boolean, routing__options__closed__action__target__id?: integer, routing__options__open__action__target__type?: string, routing__options__open__try__dial__operators?: boolean, routing__options__closed__action__target__type?: string, routing__options__closed__try__dial__operators?: boolean, advanced__settings__auto__call__recording__allow__pause__recording?: boolean, advanced__settings__auto__call__recording__call__recording__inbound?: boolean, advanced__settings__auto__call__recording__call__recording__outbound?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/call/review/share/link/privacy` — Updates the privacy settings of an existing call review share link in dialpad. this endpoint allows you to modify the accessibility of a shared call recording, controlling whether it can be viewed onl
  - body: { id: string, privacy: string }
- `POST https://api.mcp.ai/api/dialpad/update/call/subscription/by/id` — Updates an existing call event subscription in the dialpad system. this endpoint allows you to modify various aspects of a subscription, including the call states to monitor, the subscription's active
  - body: { id: integer, enabled?: boolean, target_id?: integer, call_states?: string[], endpoint_id?: integer, target_type?: string, group_calls_only?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/contact/information` — Updates an existing contact's information in the dialpad system. this endpoint allows you to modify various details of a contact, including their name, company, contact information, and job details. i
  - body: { uid: string, urls?: string[], emails?: string[], phones?: string[], extension?: string, job_title?: string, last_name: string, first_name: string, trunk_group?: string, company_name?: string }
- `POST https://api.mcp.ai/api/dialpad/update/contact/subscription/by/id` — Updates an existing contact event subscription in the dialpad system. this endpoint allows you to modify the configuration of a subscription, including changing the contact type it listens for, enabli
  - body: { id: integer, enabled?: boolean, endpoint_id?: integer, contact_type: string }
- `POST https://api.mcp.ai/api/dialpad/update/e911/address/for/office` — This endpoint updates the enhanced 911 (e911) address for a specific office in dialpad. it allows you to modify crucial location information used by emergency services to accurately locate the office 
  - body: { id: integer, zip: string, city: string, state: string, address: string, country: string, address2?: string, update_all?: boolean, use_validated_option?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/e911/address/for/user` — Updates the e911 address for a specified user in the dialpad system. this endpoint allows you to modify the emergency location information associated with a user's account, ensuring accurate dispatch 
  - body: { id: integer, zip: string, city: string, state: string, address: string, country: string, address2?: string, use_validated_option?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/ivr/details/by/id` — Updates an existing custom interactive voice response (ivr) workflow in the dialpad system. this endpoint allows you to modify the name and description of a specific ivr identified by its unique id. u
  - body: { name?: string, ivr_id: string, description?: string }
- `POST https://api.mcp.ai/api/dialpad/update/operator/duty/status` — Updates the duty status of a specific call center operator in dialpad. this endpoint allows you to change an operator's availability and optionally provide a reason for their status. use this when you
  - body: { id: integer, on_duty: boolean, duty_status_reason?: string }
- `POST https://api.mcp.ai/api/dialpad/update/recording/share/link/privacy` — Updates the privacy settings of a specific recording share link in dialpad. this endpoint allows you to modify who can access a shared call recording by changing its privacy state. use this when you n
  - body: { id: string, privacy: string }
- `POST https://api.mcp.ai/api/dialpad/update/room/details` — Updates the configuration of a specific dialpad room identified by its id. this endpoint allows you to modify the room's name and manage its assigned phone numbers. use this when you need to rename a 
  - body: { id: integer, name?: string, phone_numbers?: string[] }
- `POST https://api.mcp.ai/api/dialpad/update/schedule/report/settings` — The updatescheduledreport endpoint allows you to modify the settings of an existing scheduled report in dialpad. this powerful tool enables fine-tuning of report generation parameters, including frequ
  - body: { at: integer, id: integer, name: string, on_day: integer, enabled?: boolean, timezone?: string, frequency: string, target_id?: integer, endpoint_id: integer, report_type: string, target_type?: string, coaching_group?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/sms/subscription/settings` — Updates an existing sms event subscription in the dialpad api. this endpoint allows you to modify various aspects of an sms subscription, such as its direction, enabled status, associated endpoint, an
  - body: { id: integer, status?: boolean, enabled?: boolean, direction?: string, target_id?: integer, endpoint_id?: integer, target_type?: string, include_internal?: boolean }
- `POST https://api.mcp.ai/api/dialpad/update/user/information/by/id` — This endpoint allows you to update various aspects of a user's profile and settings in the dialpad system. it provides comprehensive control over user management, including personal information, admin
  - body: { id: string, state?: string, emails?: string[], license?: string, extension?: string, job_title?: string, last_name?: string, office_id?: integer, first_name?: string, phone_numbers?: string[], is_super_admin?: boolean, admin_office_ids?: integer[], keep_paid_numbers?: boolean, forwarding_numbers?: string[], presence__status__type?: string, presence__status__message?: string, presence__status__provider?: string }
- `POST https://api.mcp.ai/api/dialpad/validate/callback/request` — Validates a callback request for the dialpad system. this endpoint is used to check if a callback can be successfully initiated for a given call center and phone number. it helps ensure that the neces
  - body: { phone_number?: string, call_center_id?: integer }

## More
- Page: https://mcp.ai/dialpad
- Agent spec (llms.txt): https://mcp.ai/dialpad/llms.txt
- Postman collection: https://mcp.ai/dialpad/postman.json