Back to docs
API & Webhooks
API overview
Integrate Winora with your own systems using the REST API.
API overview
The Winora REST API lets you create and manage conversations, contacts, and messages programmatically. It is useful for integrating Winora with your own backend, mobile app, or third-party tools.
Base URL
https://app.winora.dev/api/v1
All endpoints accept and return JSON.
Authentication
Every request must include an API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
See Authentication for details on generating and revoking keys.
Rate limits
| Plan | Requests per minute |
|---|---|
| Starter | 60 |
| Growth | 300 |
| Gold | 1,000 |
| Platinum | 5,000 |
When a rate limit is exceeded the API returns HTTP 429. The Retry-After header tells you how many seconds to wait.
Errors
All errors follow the same shape:
{ "message": "Human-readable description of the error" }
HTTP status codes follow standard conventions: 400 (bad request), 401 (unauthenticated), 403 (forbidden), 404 (not found), 429 (rate limited), 500 (server error).