API Reference
Everything below is /api/v1/ unless noted. Base URL: https://www.connecfy.com. This table is the fast lookup; each row links to the full page with parameters, examples, and errors.
Public API — API key
Authenticated with Authorization: Bearer <api_key>. See Authentication.
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/sms/send/ | Queue an outbound SMS |
| GET | /api/v1/sms/<message_id>/ | Check a message's status |
| GET | /api/v1/sms/received/ | List inbound SMS — paginated, filterable, cursor-syncable |
| GET | /api/v1/account/stats/ | Outbound totals and success rate for your account (total_messages, queued, sent, failed, success_rate) |
Secondary send path — API key
An older, simpler alternative to /api/v1/sms/send/. It still works, but has no scheduling and no idempotency key — prefer the v1 endpoint above for anything new.
| Method | Path | Description |
|---|---|---|
| POST | /api/external/send/ | Body: {"api_key", "device_id", "to", "message"} — the key travels in the JSON body, not a header. Routes by device_id directly rather than by sender number. |
Versioning
There is one version, v1. /api/external/send/ predates the versioned namespace and remains unversioned — nothing about that is scheduled to change, but if a v2 is introduced, it will live alongside v1 rather than replacing it outright.