---
title: "Create SMS for extension"
method: POST
path: "/v4/accounts/{voip_id}/extensions/{extension_id}/sms"
tags: ["SMS"]
deprecated: true
---

# Create SMS for extension

`POST /v4/accounts/{voip_id}/extensions/{extension_id}/sms`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/extensions/{extension_id}/sms`
- Auth: HTTP bearer

> **Deprecated.**

Send a SMS to one or a group of recipients for extension.

This API endpoint is designated for Person to Person (P2P) communications. Improper use for marketing type purposes or Application to Person (A2P) will cause upstream cellular companies to block the “From” number for SMS use.  If you plan to use this endpoint for A2P or A2A applications that might also entail high volume, i.e., above the FREE limits set by the Phone.com plan, please contact our API support team at apisupport@phone.com to discuss other options.

## Path parameters

- `voip_id` integer, required
- `extension_id` integer, required

## Request body

- SMS
  - `text` string, required: Text body of the outgoing SMS message
  - `from` string, required: Phone number of sender
  - `extension_id` integer, nullable: ID of Extension where the sms is saved
  - `direction` 'out': Type of SMS direction (in or out)
  - `to` string, required: Outgoing destination numbers

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)