Ritmo de llamadas
La API acepta 500 peticiones por minuto y cuenta. Por encima, responde 429 Too Many Requests con las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y Retry-After: espere el tiempo indicado antes de reintentar. Para grandes volúmenes, agrupe: el envío de una campaña a una lista es una sola llamada, y la API CRM v3 admite operaciones por lotes sobre los contactos.
Créditos API
Cada cuenta dispone de una cuota de créditos API, calculada a partir de sus créditos de email: ×5 en las suscripciones, idéntica en las compras puntuales. Las llamadas a la API, los webhooks y OAuth se descuentan de ella. Los eventos api.limit.low y api.limit.reached le avisan antes y en el momento de alcanzar el límite (eventos webhook).
Adjuntos y tamaño de las peticiones
- Hasta 5 adjuntos por email, 10 MB por archivo y 15 MB en total.
- Los archivos ejecutables y scripts (.exe, .bat, .cmd, .js, .vbs, .msi, .jar, .ps1, .dll…) se rechazan.
- Los adjuntos se transmiten en base64, lo que aumenta su tamaño en torno a un tercio en la petición.
- Por entregabilidad, manténgase por debajo de 10 MB por email y prefiera un enlace de descarga para los archivos grandes.
Formatos y autenticación
- API Email v2 y SMS: JSON o XML, a elegir mediante la extensión de la URL (
.json/.xml). - API CRM v3: JSON, campos en
snake_case(id_sender_email,body_html…). - Autenticación: token Bearer (válido 30 días, renovable), clave API u OAuth 2.0. Todas las API responden únicamente en HTTPS.
Códigos de error y detalles por endpoint: portal para desarrolladores.