---
title: "Create a new call."
method: POST
path: "/calling/callConnections"
tags: ["CallConnection"]
---

# Create a new call.

`POST /calling/callConnections`

Create a new call.

## Query parameters

- `api-version` string, required

## Request body

- CreateCallRequest — The request payload for create call.
  - `alternateCallerId` PhoneNumberIdentifier — unresolved $ref
  - `targets` CommunicationIdentifier[], required — The targets of the call. — unresolved $ref
  - `source` CommunicationIdentifier, required — unresolved $ref
  - `subject` string — The subject.
  - `callbackUri` string, required — The callback URI.
  - `requestedMediaTypes` MediaType[] — The requested modalities.
  - `requestedCallEvents` EventSubscriptionType[] — The requested call events to subscribe to.

## Response `201`

Returns the create call response.

- CreateCallResult — The response payload of the create call operation.
  - `callConnectionId` string — The call connection id.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `500` — InternalServerError

---

[API](https://skmtc.dev/azure/apis/communication-callingserver.md) · [All operations](https://skmtc.dev/azure/apis/communication-callingserver/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-callingserver/revisions/85ed6f36b472/schema)