API — preguntas frecuentes
Respuestas rápidas para desarrolladores que integran Mailpro.
¿Cómo obtengo una clave de API?+
Inicia sesión en tu cuenta de Mailpro y abre Configuración → Acceso a la API. Encontrarás tu ID de cliente numérico y tu clave de API (GUID). Puedes llamar a las APIs directamente con esos datos o intercambiarlos por un token OAuth 2.0 / Bearer JWT desde el endpoint de token.
¿Qué métodos de autenticación se admiten?+
Tres: OAuth 2.0 con PKCE (recomendado para aplicaciones de terceros y plataformas como Zapier, Make y n8n), Bearer JWT (heredado) e id_client + clave de API. Un solo token OAuth funciona en las APIs de Email, CRM y SMS.
¿Las APIs son REST o SOAP?+
Son APIs REST modernas sobre HTTPS. Las respuestas son JSON de forma predeterminada (las APIs de Email y SMS también admiten XML), con recursos predecibles, verbos HTTP estándar y códigos de estado.
¿Hay documentación interactiva o un modo de prueba?+
Sí. Cada endpoint se puede probar en vivo desde la documentación interactiva de Swagger, y puedes enviar emails y SMS de prueba a tu propia dirección antes de pasar a producción.
¿Qué lenguajes y SDKs puedo usar?+
Cualquier lenguaje que hable HTTP y JSON. Publicamos un SDK oficial en GitHub y ofrecemos ejemplos listos para usar en curl, Node.js, Python, PHP y C#.
¿Las APIs admiten webhooks?+
Sí. Suscríbete a eventos en tiempo real — email entregado, abierto, con clic, rebotado y reportes de entrega de SMS — enviados como devoluciones de llamada HTTP firmadas con HMAC-SHA256.
¿Puedo enviar emails transaccionales, no solo campañas?+
Sí. Envía un solo email a un destinatario con campos personalizados, archivos adjuntos y programación opcional, usando la Email API o la CRM API.
¿Puedo enviar archivos adjuntos? ¿Cuáles son los límites y el costo?+
Sí — adjunta archivos cuando envías un email a través de la Email API (v2) o la CRM API (v3): hasta 5 archivos, 10 MB por archivo y 15 MB en total. Envíalos como adjuntos codificados en Base64 en cualquiera de las dos APIs (la Email API también acepta cargas de archivos multipart/form-data). El costo es de 1 crédito por cada 500 KB de adjuntos, con los primeros 500 KB incluidos en el crédito base del email (por lo que los adjuntos de hasta ~500 KB no añaden nada extra). Se aceptan formatos comunes de documento e imagen; los archivos ejecutables y de script (.exe, .bat, .js, .vbs, .msi, .jar, .dll, etc.) se bloquean por seguridad.
¿Cómo funciona el precio de los SMS?+
Los SMS se basan en créditos. Un SMS cuesta el precio en créditos del país de destino multiplicado por el número de partes (un mensaje largo se divide en varias partes). El envío de emails usa créditos de email.
¿Qué formatos de dirección de email se aceptan?+
Cualquier dirección conforme a RFC, incluida la subdireccionamiento con un "+" (por ejemplo [email protected]), que es compatible con Gmail, Fastmail, Proton y otros.
¿Cuáles son los límites de frecuencia?+
Las solicitudes tienen un límite de frecuencia por cuenta. Cuando superas el límite recibes una respuesta HTTP 429 con encabezados claros, de modo que puedes reducir el ritmo y reintentar de forma controlada.
