---
title: "Answer a Call."
method: POST
path: "/calling/callConnections:answer"
tags: ["PreConnections"]
---

# Answer a Call.

`POST /calling/callConnections:answer`

## Request

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

Answer a call using the IncomingCallContext from Event Grid.

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string, uuid
- `Repeatability-First-Sent` string, date-time-rfc1123

## Request body

- AnswerCallRequest: The request payload for answering the call.
  - `incomingCallContext` string, required: The context associated with the call.
  - `callbackUri` string, required: The callback uri.
  - `operationContext` string: A customer set value used to track the answering of a call.
  - `callIntelligenceOptions` CallIntelligenceOptions: AI options for the call.
    - `cognitiveServicesEndpoint` string: The identifier of the Cognitive Service resource assigned to this call.
  - `answeredBy` CommunicationUserIdentifierModel: A user that got created with an Azure Communication Services resource.
    - `id` string, required: The Id of the communication user.
  - `mediaStreamingOptions` MediaStreamingOptions: Options for media streaming.
    - `transportType` 'websocket', required: Defines the transport type used for streaming. Note that future values may be introduced that are not currently documented.
    - `audioChannelType` 'mixed' | 'unmixed', required: The audio channel type to stream, e.g., unmixed audio, mixed audio.
  - `transcriptionOptions` TranscriptionOptions: Options for live transcription.
    - `transportType` 'websocket', required: Defines the transport type used for streaming. Note that future values may be introduced that are not currently documented.
    - `locale` string, required: Specifies the Locale used for transcription, e.g., en-CA or en-AU.

## Response `200`

Returns details of the call properties once the AnswerCall request is received by service. You will receive CallConnected event at your specified callback URI, once the call is connected.

- CallConnectionProperties: Properties of a call connection
  - `callConnectionId` string: The call connection id.
  - `serverCallId` string: The server call id.
  - `targets` CommunicationIdentifierModel[]: The targets of the call.
    - `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.
  - `callConnectionState` 'unknown' | 'connecting' | 'connected' | 'transferring' | 'transferAccepted' | 'disconnecting' | 'disconnected': The states of a call connection.
  - `callbackUri` string: The callback URI.
  - `sourceCallerIdNumber` PhoneNumberIdentifierModel: 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.
  - `sourceDisplayName` string: Display name of the call if dialing out to a pstn number.
  - `source` CommunicationIdentifierModel: 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.
  - `correlationId` string: The correlation ID.
  - `answeredBy` CommunicationUserIdentifierModel: A user that got created with an Azure Communication Services resource.
    - `id` string, required: The Id of the communication user.
  - `mediaStreamingSubscription` MediaStreamingSubscription: Media streaming Subscription Object.
    - `id` string: Subscription Id.
    - `state` 'disabled' | 'inactive' | 'active': Current state of media streaming session
    - `subscribedContentTypes` MediaStreamingContentType[]: Subscribed media streaming content types.
  - `transcriptionSubscription` TranscriptionSubscription: Transcription Subscription Object.
    - `id` string: Subscription Id.
    - `state` 'disabled' | 'inactive' | 'active': Current state of transcription session
    - `subscribedResultTypes` TranscriptionResultType[]: Subscribed transcription result types.
    - `locale` string: Specifies the locale used for transcription, e.g., en-CA or en-AU.
  - `answeredFor` PhoneNumberIdentifierModel: 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.

## Other responses

- `default`: Error

## Changes

- **2026-07-13** (2022-04-07-preview) `d4d02a642780`: 1 info
  - api operation id `ServerCalling_AnswerCall` removed and replaced with `AnswerCall`

[Operation history](https://skmtc.dev/azure/apis/communication-callautomation/changes/calling/callConnections:answer/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)
