---
title: "Connect a call"
method: POST
path: "/whatsapp/calls/connect"
tags: ["WhatsApp Calling"]
---

# Connect a call

`POST /whatsapp/calls/connect`

Initiates a WhatsApp call connection.

Establishes the initial connection for a WhatsApp call by providing SDP offer information.
This endpoint is used for business-initiated calling scenarios.

## Request body

- WhatsappCallingConnectRequest — Provide exactly one of `to` or `recipient`. If both are provided, `to` takes precedence and `recipient` is ignored.
  - `from` string, required — The caller's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format.
  - `to` string — The callee's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format. Required when `recipient` is not provided.
  - `recipient` string — The callee's WhatsApp Business-scoped user ID (BSUID) or parent BSUID. Required when `to` is not provided.
  - `sdpType` 'offer', required — The SDP type, must be "offer" for connection requests.
  - `sdp` string, required — The Session Description Protocol (SDP) offer information compliant with [RFC 8866](https://datatracker.ietf.org/doc/html/rfc8866). Contains media session parameters for establishing the WebRTC connection.

## Response `200`

The call connection request is successfully accepted.

- WhatsappCallingResponse
  - `wacid` string — The WhatsApp call ID associated with this calling operation.
  - `success` boolean, required — Indicates whether the calling operation was successful.

## Other responses

- `400` — Bad request. Invalid request parameters.
- `404` — The requested resource does not exist.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)