DocsReferencia de API
Referencia de API
Construya sobre BeeCastly con nuestra API REST con todas las funciones. Administre contactos, envíe mensajes, cree campañas y configure webhooks mediante programación.
URL base
https://beecastly.com/api/v1Every endpoint that accepts an API key lives under /api/v1. The key identifies your workspace — there is no tenant header to send.
Inicio rápido
curl "https://beecastly.com/api/v1/contacts?page=1&limit=20" \ -H "x-api-key: YOUR_API_KEY"
Autenticación
Send your API key in the x-api-key header. Create keys under Settings → API Keys and choose their access when you create them:
- Read only — GET requests.
- Read & write — also POST: send messages, create contacts.
Puntos finales API
Formato de respuesta
Cada respuesta es JSON con la misma estructura:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Límites de tarifas
Two limits apply to every API-key request, both set by your plan:
- Per key, per minute — the plan's ceiling, or the key's own limit if lower. Over it:
429with codeAPI_KEY_RATE_LIMITED. - Per workspace, per day — shared by all your keys, resets at 00:00 UTC. Over it:
429with codeAPI_DAILY_LIMITand aRetry-Afterheader. Every response carriesX-Daily-LimitandX-Daily-Remaining.
| Plan | Requests / minute (per key) | Requests / day (workspace) | Webhook endpoints |
|---|---|---|---|
| Free | 5 | 100 | 2 |
| Starter | 20 | 2,500 | 10 |
| Growth | 100 | 15,000 | 30 |
| Pro | 300 | 60,000 | 100 |
| Agency | 1,000 | 500,000 | Unlimited |
The BeeCastly Chrome extensions use their own keys and do not count toward the daily allowance.