send-text-message

Send SMS text messages via the Textbelt API with delivery status checks.

12|4|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/orthogonal-sh/skills --skill send-text-message
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: send-text-message
Source: https://github.com/orthogonal-sh/skills/tree/main/skills/orthogonal-send-text-message
Command: npx skills add https://github.com/orthogonal-sh/skills --skill send-text-message

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Send SMS text messages to phone numbers via the Textbelt API to notify users, alert recipients, or confirm actions through text messages.

Core Features & Use Cases

  • Send a text message to a phone number via the Textbelt API.
  • Check delivery status using a status endpoint and track the resulting textId.
  • Support optional metadata such as sender name and webhook data for delivery and replies.

Quick Start

Send a test message by using orth run textbelt /text with a sample body and then verify delivery using orth run textbelt /status/{textId}.

Frequently Asked Questions about send-text-message

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an SMS text message to a phone number via an API?

To send an SMS text message, you call the Textbelt API endpoint with a request body containing the recipient phone number and the message text. This routes your text payload to US, Canada, or international numbers.

How can I check the delivery status of an SMS message after sending it?

You can check SMS delivery status by querying the Textbelt status endpoint with the unique textId returned from your original message request. This tracks whether the text reached the recipient successfully.

Can I attach webhook data or a sender name when sending text messages?

Yes, you can include optional webhook data and sender name metadata when sending text messages. This allows you to capture delivery receipts and replies, routing status updates directly to your specified webhook URL.

What are the character limits and restrictions for sending SMS messages through Textbelt?

Sending SMS messages through Textbelt enforces an 800-character limit on the message body and disallows URLs within the text content. Messages exceeding this length or containing links will be rejected by the API.

Does the Textbelt SMS API support international phone numbers?

Yes, the Textbelt SMS API supports sending text messages to both US/Canada and international phone numbers. You simply provide the valid international phone number format in your API request body.

Why did my SMS text message fail to send through the webhook notification system?

Your SMS text message may have failed if the payload exceeded the 800-character limit, contained disallowed URLs, or lacked a valid phone number. Check the textId status to verify the delivery error details.