---
title: "Send A Message"
method: POST
path: "/api/v1/messaging/{widget_id}"
tags: ["Messaging"]
---

# Send A Message

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

To send a text message to a given telephone number or a contact
- **widget_id**: Widget ID to be used for initiating the call. It must be connected to WhatsApp or SMS.
- **to**: phone number of the recipient. should contain the country code. For ex: 16501111234 
- **contact_id**: contact ID to whom the message is to be sent. (either to or contact_id must be given)
- **message**: text message to be sent.
- **start_new_conversation**: whether to start a new conversation or pick the latest.

## Path parameters

- `widget_id` string, uuid, required

## Request body

- SendMessagePayload
  - `to` string, nullable
  - `contact_id` string, uuid, nullable
  - `message` string, nullable
  - `start_new_conversation` boolean, nullable
  - `widget_parameters` object, nullable
  - `conversation_id` string, uuid, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation 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)