How to Send a SMS

To send SMS messages using this API, follow the steps below:

Send text messages to multiple recipients using the LigueLead API's simple one-step process.

📋 Prerequisites

Valid api-token and app-id from your LigueLead account, or an app-id created through the API
Target phone numbers in Brazilian format
SMS message content (text)

📱 Send SMS Message

Send SMS messages to multiple recipients with a single API call.

1️⃣ Get Your Credentials

Access your account at areadocliente.liguelead.app.br
Navigate to Integrations → API Token
Copy your api-token and app-id

2️⃣ Prepare the Request

Endpoint:POST /v1/sms📄 Send SMS – API Reference

Request Example

curl -X POST "https://api.liguelead.com.br/v1/sms" \
  -H "api-token: YOUR_API_TOKEN" \
  -H "app-id: YOUR_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Welcome Campaign",
    "message": "Welcome to LigueLead! Thank you for joining us.",
    "phones": ["5511999999999", "5511888888888"]
  }'

Response

{
  "message": "SMS accepted successfully",
  "data": {
    "campaign_id": "3b4f7c5e-7e2d-4157-b542-5eb2155455c5",
    "accepted_at": "2025-12-29T18:34:38.961Z"
  }
}

💡 Tip: Save the returned campaign_id for tracking delivery status later.

📋 Request Parameters

Parameter	Type	Required	Description
`title`	string	❌	Campaign identifier for organization
`message`	string	✅	SMS text content to be sent
`phones`	array	✅	Brazilian phone numbers (multiple formats accepted)
`group_id`	string	❌	Deprecated: accepted for compatibility, has no effect on the send
`is_flash`	boolean	❌	Defines whether the message will be sent via Flash.
`webhook_url`	string	❌	URL that receives the status of this send instead of the app's webhook URL, called exactly as written (query string included). Up to 512 characters; see How to Receive Webhooks

📱 Phone Number Format

The API accepts Brazilian phone numbers in multiple formats:

✅ National Format:

São Paulo: "11999999999"
Rio de Janeiro: "21999999999"
Brasília: "61999999999"
Belo Horizonte: "31999999999"

✅ International Format:

São Paulo: "+5511999999999"
Rio de Janeiro: "+5521999999999"
Brasília: "+5561999999999"

✅ DDI Format:

São Paulo: "5511999999999"
Rio de Janeiro: "5521999999999"
Brasília: "5561999999999"

Recommendation: Send numbers with the country code (5511999999999 or +5511999999999). Without it, the length decides: 10 or 11 digits are a national number and get 55 in front — area code 55 included, so 55991234567 is sent as 5555991234567.

⚡ Processing & Delivery

Asynchronous Processing: SMS messages are queued for delivery
Response Code: 200 OK indicates successful queuing
Delivery Time: Usually within minutes, depending on carrier
Character Limit: 160 characters per SMS (longer messages charged additional credits)

🚀 Best Practices

Clear Messages: Keep SMS content concise and actionable
Test First: Send to a small group before scaling up
Timing Matters: Consider Brazilian business hours for better engagement
Descriptive Titles: Use clear campaign titles for easy identification

🚫 SMS Flash Restrictions

SMS Flash messages do not allow sending links (URLs) in the message content.

🛠️ Troubleshooting

Issue	Solution
Invalid phone format	Ensure valid Brazilian phone number format (11 digits or with DDI)
Authentication error	Verify `api-token` and `app-id` headers
Message too long	Keep within 1,600 characters
Empty phones array	Include at least one valid phone number

📈 SMS Campaign Ideas

E-commerce

Order confirmations
Shipping updates
Promotional offers
Abandoned cart reminders

Healthcare

Appointment reminders
Medication alerts
Health tips
Test results notifications

Education

Class schedules
Important announcements
Grade notifications
Event reminders

Retail

Store promotions
New product launches
Seasonal campaigns
Customer surveys

🔐 Security & Compliance

Data Protection: Ensure compliance with Brazilian data protection laws (LGPD)
Opt-in Required: Only send SMS to customers who have consented
Rate Limits: Respect API rate limits to avoid blocking
Content Guidelines: Avoid spam-like content that could be filtered

📞 Support

Need help with SMS integration? Contact our support team through the LigueLead Client Area.