---
title: "Send sms to first sms enable TN for provided campaign"
method: POST
path: "/sms"
tags: ["sms"]
---

# Send sms to first sms enable TN for provided campaign

`POST /sms`

Sends an SMS message from the first SMS-enabled tracking number associated with a specified campaign. Used for outbound text messaging to customers via campaign tracking numbers.

## Request body

- Sendsms
  - `campaign_id` integer — Unique identifier for the campaign this call was attributed to. Integer.
  - `tracking_number` string — Phone number the caller dialed (the tracking/DNI number). Convirza routes calls from this number through the configured call flow. String of digits.
  - `destination_number` string, required — destination number to which sms should be sent. Type: string.
  - `message` string, required — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).
  - `sms_type` 'outgoing' | 'incoming' — sms_type. Type: enum (string); Allowed values: outgoing, incoming.
  - `send_opt_in_msg` boolean — Indicates whether the opt-in messages to be sent or not. Type: boolean.
  - `opt_in_msg` string — content of the otp-in message to the customer to be sent. Type: string.
  - `agent_notification` string — content of the agent notification to be sent. Type: string.

## Response `200`

Confirmation of SMS submission with unique message ID, delivery status, and message details

- Sendsmsresponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string — Error message if result is error. Null if successful.
  - `data` object — SMS message identifiers for tracking and reference
    - `sms_id` string, required — Unique identifier for the sent SMS message. Use this to track delivery status and identify individual messages. String representation of integer ID.
    - `conversation_id` integer, required — Unique identifier for the SMS conversation thread. Multiple messages between the same parties share the same conversation_id.

## Other responses

- `default` — Unexpected error

---

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