---
title: "Start a phone call"
method: POST
path: "/messenger/v1/telephony/call/start"
tags: ["telephony"]
---

# Start a phone call

`POST /messenger/v1/telephony/call/start`

## Request

- Base URL: `https://{domain}.uspacy.ua`
- URL: `https://{domain}.uspacy.ua/messenger/v1/telephony/call/start`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/uspacy/apis/messenger-service-2/docs/messenger/v1/telephony/call/start/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiates a new phone call event. Used to track and manage telephony integration calls.

## Request body

- CallEventDto
  - `call_type` 'incoming' | 'outgoing', required: Call type
  - `from` string, required: Call from
  - `to` string, required: Call to
  - `call_event_id` number, required: Call event id
  - `auth_user_id` number, required: Auth user id
  - `integration_code` string, required: Integration code
  - `time` string, required: Hangup button
  - `status` string, required: Status
  - `note` string: Note
  - `hangup_button` HangupButtonEventDto, required
    - `url` string, required: Hangup button url
    - `data` HangupButtonEventDataDto, required
      - `id` number, required: Hangup button id

## Response `200`

Call started successfully

---

[API](https://skmtc.dev/uspacy/apis/messenger-service-2.md) - [All operations](https://skmtc.dev/uspacy/apis/messenger-service-2/llms.txt) - [OpenAPI document](https://skmtc.dev/uspacy/apis/messenger-service-2/revisions/699626a9e425?raw)