---
title: "Start continuous Dtmf recognition by subscribing to tones."
method: POST
path: "/calling/callConnections/{callConnectionId}:startContinuousDtmfRecognition"
tags: ["MidConnections"]
---

# Start continuous Dtmf recognition by subscribing to tones.

`POST /calling/callConnections/{callConnectionId}:startContinuousDtmfRecognition`

## Request

- Base URL: `https://contoso.communication.azure.com`
- URL: `https://contoso.communication.azure.com/calling/callConnections/{callConnectionId}:startContinuousDtmfRecognition`
- Auth: API key in header `Authorization`

## Path parameters

- `callConnectionId` string, required

## Query parameters

- `api-version` string, required

## Request body

- ContinuousDtmfRecognitionRequest
  - `targetParticipant` CommunicationIdentifierModel, required: Identifies a participant in Azure Communication services. A participant is, for example, a phone number or an Azure communication user. This model is polymorphic: Apart from kind and rawId, at most one further property may be set which must match the kind enum value.
    - `kind` 'unknown' | 'communicationUser' | 'phoneNumber' | 'microsoftTeamsUser' | 'microsoftTeamsApp' | 'teamsExtensionUser': The identifier kind, for example 'communicationUser' or 'phoneNumber'.
    - `rawId` string: Raw Id of the identifier. Optional in requests, required in responses.
    - `communicationUser` CommunicationUserIdentifierModel2: A user that got created with an Azure Communication Services resource.
      - `id` string, required: The Id of the communication user.
    - `phoneNumber` PhoneNumberIdentifierModel2: A phone number.
      - `value` string, required: The phone number, usually in E.164 format.
      - `isAnonymous` boolean: True if the phone number is anonymous. By default false if missing. If the phone number is anonymous, the value will be the string 'anonymous'.
      - `assertedId` string: The asserted Id of the phone number. An asserted Id gets generated when the same phone number joins the same call more than once.
    - `microsoftTeamsUser` MicrosoftTeamsUserIdentifierModel2: A Microsoft Teams user.
      - `userId` string, required: The Id of the Microsoft Teams user. If not anonymous, this is the Entra ID object Id of the user.
      - `isAnonymous` boolean: True if the Microsoft Teams user is anonymous. By default false if missing.
      - `cloud` 'public' | 'dod' | 'gcch': The cloud that the identifier belongs to.
    - `microsoftTeamsApp` MicrosoftTeamsAppIdentifierModel2: A Microsoft Teams application.
      - `appId` string, required: The Id of the Microsoft Teams application.
      - `cloud` 'public' | 'dod' | 'gcch': The cloud that the identifier belongs to.
    - `teamsExtensionUser` TeamsExtensionUserIdentifierModel2: A Microsoft Teams Phone user who is using a Communication Services resource to extend their Teams Phone set up.
      - `userId` string, required: The Id of the Microsoft Teams Extension user, i.e. the Entra ID object Id of the user.
      - `tenantId` string, required: The tenant Id of the Microsoft Teams Extension user.
      - `resourceId` string, required: The Communication Services resource Id.
      - `cloud` 'public' | 'dod' | 'gcch': The cloud that the identifier belongs to.
  - `operationContext` string: The value to identify context of the operation.
  - `operationCallbackUri` string: Set a callback URI that overrides the default callback URI set by CreateCall/AnswerCall for this operation. This setup is per-action. If this is not set, the default callback URI set by CreateCall/AnswerCall will be used.

## Response `200`

The service has started continuous dtmf recognition. You will receive either the ContinuousDtmfRecognitionToneReceived, ContinuousDtmfRecognitionToneFailed or ContinuousDtmfRecognitionStopped event at your specified callback URI. Continuous dtmf recognition can run in parallel with other media operations. For example if the Recognize operation is also active and a dtmf is detected, both ContinuousDtmfRecognitionToneReceived and RecognizeCompleted events will be received.

## Other responses

- `default`: Error

## Changes

- **2026-07-13** (2022-04-07-preview) `9b47892a2511`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/azure/apis/communication-callautomation/changes/calling/callConnections/:callConnectionId:startContinuousDtmfRecognition/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-callautomation.md) - [All operations](https://skmtc.dev/azure/apis/communication-callautomation/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/communication-callautomation/revisions/956a07c67cf4?raw)
