---
title: "Make a call"
method: POST
path: "/api/v1/call/{widget_id}"
tags: ["Calling"]
---

# Make a call

`POST /api/v1/call/{widget_id}`

To make an outbound call to a given telephone number

## Path parameters

- `widget_id` string, uuid, required — Widget ID to be used for initiating the call. It must be connected to Twilio, Plivo or Telnyx.

## Request body

- MakeCallPayload
  - `to` string, required — The phone number to call. Must be in E.164 format. Ex: 16501234567
  - `prompt_dynamic_variables` object, nullable — Dynamic variables to be used in the prompt. Ex: {'name': 'Bob', 'appointment_day': 'tomorrow', 'reason': 'for confirmation of appointment'}

## Response `201`

Call successfully initiated

- IPostResponseBaseCall
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` Call
    - `conversation_id` string, uuid, required — The unique ID of the conversation. Ex: 123e4567-e89b-12d3-a456-426614174000
    - `contact_id` string, uuid, required — The unique ID of the contact. Ex: 123e4567-e89b-12d3-a456-426614174000
    - `widget_id` string, uuid, required — The unique ID of the widget used for the call. Ex: 123e4567-e89b-12d3-a456-426614174000
    - `assistant_id` string, uuid, required — The unique ID of the assistant used for the call. Ex: 123e4567-e89b-12d3-a456-426614174000
    - `direction` string, required — The direction of the call. Must be either 'inbound' or 'outbound'.
    - `from_number` string, required — Phone number to call from. Ex: 16501234567
    - `to_number` string, required — Phone number to call to. Ex: 16501234567
    - `telephony_provider` TelephonyProviderCallDetails, required
      - `provider_name` 'twilio' | 'plivo' | 'telnyx' | 'sip', required
      - `call_id` string, required — The ID of the telephony provider. Ex: Twilio CallSID, Plivo Call UUID, etc.
      - `response_body` object, required — Complete response body from the telephony provider
    - `prompt_dynamic_variables` object, nullable — Dynamic variables to used in the prompt. Ex: {'name': 'Bob', 'appointment_day': 'tomorrow', 'reason': 'for confirmation of appointment'}

## Other responses

- `400` — Invalid input, such as malformed phone number
- `401` — Authentication credentials are missing or invalid
- `404` — Widget not found or not configured for telephony
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal server error

---

[API](https://skmtc.net/insighto/apis/ragify.md) · [All operations](https://skmtc.net/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insighto/ragify/revisions/cdca56191be9/schema)