Send Text Message
send_messageSend a message immediately via Mobile Text Alerts API. Use this tool for messages that need to be sent right away. For scheduling messages to be sent at a future time, use the schedule_message tool instead. The message goes out from the account's default number (the one it last sent from) unless from names another; the response's sentFrom says which was used, and notice carries anything to tell the user, such as a send from a limited trial number. PREREQUISITE: User must complete onboarding first (status must be 'ACTIVE'). If this tool returns 'Onboarding Required' error, immediately call get_onboarding_status to begin the onboarding flow.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>",
"message": "<message>"
},
"name": "send_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Recipient phone number (can be formatted as +1234567890, 234-567-8900, (234) 567-8900, etc.) | |
| from | No | Sending phone number. Omit to use the account's default (the number it last sent from). Use list_sending_numbers to see options. | |
| message | Yes | Message content to send |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Raw Mobile Text Alerts API response envelope. The send payload is nested one level down, under `data.data` — e.g. `data.data.messageId`. | |
| error | No | ||
| notice | No | Something the user should be told about this send, e.g. that it used a limited trial number | |
| status | Yes | ||
| context | No | Additional context about why the call was blocked | |
| success | Yes | ||
| sentFrom | No | The number the message was sent from | |
| errorCode | No | Machine-readable error code. 'ONBOARDING_REQUIRED' means the account has not finished brand registration. 'NO_SENDING_NUMBER' means no number on the account can send yet; 'SENDING_NUMBER_NOT_FOUND' / 'SENDING_NUMBER_UNAVAILABLE' mean the requested `from` number is not on the account or can't send. 'AUTH_FAILED', 'RATE_LIMITED', 'UPSTREAM_ERROR' and 'UPSTREAM_UNAVAILABLE' are Mobile Text Alerts API failures. | |
| nextSteps | No | Explicit recovery guidance for the calling agent | |
| statusText | Yes | ||
| formattedPhone | No |