Sender Number Is Not Active
Sender Account Is Not Verified
API Key Does Not Have The Required Scope
Make sure the key has the required scope, such as:Recipient Cannot Receive Messages
Use contact lookup before sending to confirm the recipient exists and can receive messages.Voice Note Duration Is Missing
voice is reserved for a recorded voice note and requires duration as an integer from 1 to 300 seconds.
For an uploaded audio file, send type=audio instead. Its duration is optional; when provided, it must be a positive integer and is not limited to 300 seconds.
Media Validation Fails
The API validates both the uploaded file type and its size:- Images: JPEG, JPG, PNG, GIF, or WebP; up to 10 MB.
- Audio files and voice notes: M4A, MP3, WAV, OGG, MP4, AAC, CAF, or 3GP; up to 20 MB.
- Documents: PDF, DOC, DOCX, XLS, XLSX, or TXT; up to 25 MB.
multipart/form-data, send one file in the media field, and make sure the file extension and detected media type match. See Messaging for complete examples.
Common HTTP Responses
401 Unauthenticated
X-Api-Key header is present, active, and not expired.
404 Tenant Domain Not Found
{tenant}.sinjapp.org and {other-tenant}.sinjapp.org are different tenants.
403 Insufficient Scope
messages.send, messages.read, contacts.lookup, or usage.read.
422 Validation Error
errors object and fix each field before retrying.