”No estoy recibiendo correo por los envíos”
Casi siempre es uno de estos, en orden de probabilidad:- El correo de destino todavía no está verificado. El destino de un formulario nuevo retiene toda la entrega hasta que ingreses el código de 6 dígitos que Formpaste le envió por correo. Revisa la pestaña Setup del formulario en el panel en busca de un estado de “pending verification”. Consulta Tu primer formulario.
- El envío llegó a cuarentena, no al inbox. Los envíos en cuarentena nunca se envían por correo, ese es el propósito de la cuarentena. Revisa la pestaña Spam del formulario; si está ahí, consulta la sección de cuarentena abajo.
- Estás sobre tu cuota mensual. Una vez que se cruza el límite de envíos de un plan para el mes de facturación, los envíos siguientes se aceptan y almacenan pero se retienen en lugar de enviarse por correo hasta que el mes cambie o mejores tu plan. Consulta Límites del plan gratuito.
- Revisa spam/correo no deseado en tu buzón real, fuera del control de Formpaste, pero la falsa alarma más común.
”403 domain_not_allowed”
El origen de la página que envía no está en la lista permitida de este formulario. Abre la pestaña Setup del formulario → Allowed domains y agrega el dominio desde el que se sirve el formulario (por ejemplo,example.com para https://example.com/contact). Si la lista permitida
está vacía, se acepta cualquier origen, así que esto solo se activa una
vez que has restringido un formulario. Consulta Lista permitida de
dominios.
”401 invalid_access_key”
El campoaccess_key no se envió, no coincide con ningún formulario, o
pertenece a un formulario que fue eliminado. Vuelve a copiar la clave
desde la pestaña Setup del formulario en el panel (o llama a
get_snippet con el formId para obtener un
snippet con la clave real ya incluida) y asegúrate de que sea el valor de
un campo access_key en el cuerpo de la solicitud, no un encabezado
Authorization. /submit no acepta autenticación Bearer; eso es solo
para el servidor MCP.
”Mi envío quedó en cuarentena”
Formpaste puntúa cada envío con heurísticas de spam (honeypot, tiempo, densidad de enlaces, tasa, correo desechable/duplicado) y enruta cualquier cosa sospechosa a la pestaña Spam en lugar de descartarla, consulta Filtrado de spam para lo que se verifica. Causas comunes de un falso positivo:- El campo honeypot
botcheckrecibió accidentalmente unvaluereal, o tu CSS lo oculta de una forma que un autocompletado del navegador o una extensión todavía puede rellenar. - El formulario se envió más rápido de lo que
_tssugiere que un humano podría completarlo, común en pruebas automatizadas; no suele ser un falso positivo en tráfico real de producción. - El
emailenviado pertenece a un dominio de proveedor desechable yallow_disposable_emailestá desactivado para este formulario.
allow_disposable_email) y haz que el visitante lo reenvíe.
”400 missing_access_key / invalid_body”
missing_access_key significa que no se envió ningún campo access_key
en absoluto, verifica que el nombre del input sea exactamente
access_key, sin errores de tipeo, y que realmente esté dentro del
<form> (o el cuerpo FormData/JSON) que se envía. invalid_body
significa que el cuerpo de la solicitud no pudo interpretarse como JSON o
datos de formulario, verifica que Content-Type coincida con lo que
realmente estás enviando (application/json para un cuerpo JSON, dejado
al valor por defecto del navegador para un formulario HTML simple o
FormData).
“400 invalid_redirect”
La URL del camporedirect no está en la lista de dominios permitidos de
este formulario. Agrega ese dominio a Allowed domains, o elimina el
campo redirect si estás enviando vía fetch/AJAX y no necesitas una
navegación de página. Consulta Redirecciones.
”403 upgrade_required”
Estás en Free e intentaste usar o configurar una capacidad exclusiva de Pro: rescate de cuarentena, respuesta automática, destinatarios adicionales/CC, webhooks, o subida de archivos. Consulta Límites del plan gratuito para la lista completa, o Plan Pro para mejorar.”429 rate_limited”
Demasiados envíos desde la misma fuente en una ventana corta. Esto es independiente del contenido, se activa incluso con tráfico legítimo si es en ráfagas. Ralentiza la lógica de reintentos (backoff exponencial, no un bucle ajustado) y se resuelve por sí solo.”Mi webhook no se activa”
Los webhooks solo se activan para envíos entregados y que no sean spam, un envío en cuarentena nunca activa uno. Confirma quewebhook_url está
establecido y que Pro está activo en la cuenta, revisa el registro de
entregas por formulario del panel en busca de intentos fallidos, y
confirma que tu endpoint sea https:// y devuelva un 2xx rápidamente.
Consulta Webhooks para el tiempo de reintentos y la
receta de verificación de firma.
”¿Necesito un CAPTCHA?”
No, Formpaste está diseñado específicamente para que no agregues uno. El spam se detecta con el honeypotbotcheck, el tiempo _ts, y
heurísticas del lado del servidor en su lugar. Consulta Prevenir
spam.
”¿Hay una API REST para envíos/formularios?”
No. Los formularios se crean en el panel o mediante la herramienta MCPcreate_form; los envíos se leen mediante el
panel, la exportación CSV, o la herramienta MCP
list_submissions. Consulta Recuperar
envíos para el desglose completo, no hay
ninguna API REST GET/POST para formularios o envíos más allá de
POST /submit en sí.
Referencia de errores
Cada código, su estado HTTP, y su mensaje.
Referencia de opciones
Los campos reservados y la configuración del panel con la que se relacionan estos errores.