API Overview
Base URL, phone number format, and navigation for the Safravo Developer API.
The Safravo Developer API lets you send messages, manage contacts, and handle automated workflows across WhatsApp, Instagram, and Messenger. All endpoints are under the /v1/ prefix.
Base URL
https://api.safravo.comAll requests must use HTTPS. Plain HTTP requests are rejected.
Authentication
Every request must include your API key in the X-API-Key header. See Authentication for details on generating keys and available scopes.
Phone number format
All phone numbers across the Safravo API must be in E.164 format.
Requirements:
- Starts with
+ - Followed by the country code (e.g.
254for Kenya,1for USA) - No spaces, dashes, or leading zeros in the local number
Examples:
| Value | Valid? |
|---|---|
+254712345678 | ✅ Kenya |
+14155552671 | ✅ USA |
0712345678 | ❌ Missing + and country code |
+254 712 345 678 | ❌ Contains spaces |
Requests with incorrectly formatted phone numbers are rejected with a
validation_error.
Endpoints
| Resource | Description |
|---|---|
| Authentication | API keys, scopes, and security best practices |
| Messages | Send text, media, and WhatsApp template messages |
| Contacts | Create, list, search, and update contacts |
| Templates | Discover approved WhatsApp templates |
| Webhooks | Receive real-time push events |
| Errors | Error shapes, status codes, and handling patterns |