API Documentation
Use the following documentation to integrate JulySMS into your application
- Aunthetication
Send your Client ID and Client Secret as HTTP headers with every request:
Client-ID: YOUR_CLIENT_ID
Client-Secret: YOUR_CLIENT_SECRET
Login HERE to get your Client ID and Client Secret
- Send SMS
Endpoint: POST https://app.julysms.com/api/v1/sms/send
{
"phone": "0700000000",
"message": "Hello from JulySMS!"
}
{
"phones": ["0700000000", "0700000001"],
"message": "Hello team!"
}
curl -X POST https://app.julysms.com/api/v1/sms/send \
-H "Client-ID: YOUR_CLIENT_ID" \
-H "Client-Secret: YOUR_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-d '{"phones": ["0700000000", "0700000001"], "message": "Hello team!"}'
- Check Balance
Endpoint: GET https://app.julysms.com/api/v1/sms/balance
curl -X GET https://app.julysms.com/api/v1/sms/balance \
-H "Client-ID: YOUR_CLIENT_ID" \
-H "Client-Secret: YOUR_CLIENT_SECRET"
- Best Practices
- You are charged 1 unit per 160 characters per recipient.
- If both phone and phones are given, phones will be used.
- Always check your balance before sending bulk SMS to avoid errors.
- Keep your credentials secret. If compromised, regenerate them immediately.
- Always use HTTPS for secure communication: https://app.julysms.com