---
title: "Send a test SMS to the specified phone number"
method: POST
path: "/sms/v1/test/messages"
tags: ["SMS Libraries and APIs"]
---

# Send a test SMS to the specified phone number

`POST /sms/v1/test/messages`

Send a test SMS to the specified phone number. This is for testing purposes only.
Fixed message content is used for testing, and the message will not be persisted in the database.

## Request body

- AssistantSMSPayload
  - `to` string, nullable — Phone number to which SMS to be sent.
  - `from_` string, nullable — Phone number from which SMS is received.
  - `body` string, nullable — Message content of SMS
  - `numSegments` integer, nullable — Carrier segment count for the message. Inbound SMS is billed per segment.
  - `assistantId` string, nullable
  - `teamId` string, nullable
  - `botconfig` object, nullable
  - `meta` object, nullable
  - `skipSmsLog` boolean, nullable — If true, skip persisting an SMSLogs record for this send (e.g. OTP messages).

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 3 revisions in range; 1 could not be searched.

- **2026-07-26** `d07d77ada918` — 1 info
  - added the new optional request property `skipSmsLog`

[Change history](https://skmtc.dev/interactly/apis/interactly-api-6/changes/sms/v1/test/messages/post.md)

---

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