Base URL & Errors

Base URL

All API endpoints are served from:

https://whatsapp-backend.developnetwork.net/api/v1

Request format

• All request bodies must be JSON (Content-Type: application/json).
• All responses are JSON.

HTTP status codes

Code	Meaning
200	Success
201	Resource created
401	Unauthorized — missing or invalid API key
404	Resource not found (e.g. account_id doesn't belong to you)
422	Validation error or message send failure
429	Rate limit exceeded — slow down and retry
500	Internal server error — contact support

Error response shape

When a request fails, the response body always includes an error field and optionally a human-readable message:

{
  "error": "Unauthorized",
  "message": "Provide your API key via Authorization: Bearer <key>."
}

Validation errors (422)

Validation failures include a errors map keyed by field name:

{
  "message": "The to field is required.",
  "errors": {
    "to": ["The to field is required."]
  }
}

Retry guidance

Status	Retry?
401	No — fix your API key
404	No — fix the resource ID
422	No — fix the request body
429	Yes — wait 60 s then retry
5xx	Yes — use exponential back-off