> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de opciones

> Cada campo reservado de /submit y cada opción del panel por formulario, en un solo lugar.

Dos tipos de "opciones" aplican a un formulario de Formpaste: campos que
pones directamente en el `<form>` y que lee `/submit`, y configuración por
formulario que estableces una vez en el panel. Esta página es la lista
completa de ambos.

## Campos reservados (en el cuerpo del formulario)

Estos nombres de campo son leídos por `/submit` mismo, ponlos como inputs
en tu formulario (o como claves en tu cuerpo JSON/`FormData`). Cualquier
otro nombre de campo es tuyo.

| Campo        | Obligatorio | Propósito                                                                                                                                                                                                                                                               |
| ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `access_key` | **Sí**      | Identifica a qué formulario pertenece el envío (`fp_…`). Sin él, o con uno inválido, el envío se rechaza, consulta `missing_access_key` / `invalid_access_key` en la [referencia de errores](/docs/es/reference/error-table).                                                |
| `botcheck`   | No          | Honeypot. Un campo oculto que los visitantes reales nunca completan. Si llega con un valor no vacío, el envío se pone en cuarentena. Consulta [Filtrado de spam](/docs/es/features/spam-filtering).                                                                          |
| `_ts`        | No          | Marca de tiempo de cuando se renderizó el formulario, usada para heurísticas de spam basadas en el tiempo, un envío que llega de forma implausiblemente rápida se puntúa como sospechoso.                                                                               |
| `redirect`   | No          | Una URL a la que redirigir al visitante con `303` tras un envío exitoso sin JS. Debe estar en la lista de [dominios permitidos](/docs/es/features/custom-domains) del formulario, o el envío falla con `invalid_redirect`. Consulta [Redirecciones](/docs/es/features/redirects). |

```html theme={null}
<form action="https://api.formpaste.com/submit" method="POST">
  <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
  <input type="text" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">
  <input type="hidden" name="_ts" value="1720700000000">
  <input type="hidden" name="redirect" value="https://example.com/thank-you">
  <input type="email" name="email" placeholder="Your email" required>
  <textarea name="message" placeholder="Your message" required></textarea>
  <button type="submit">Send</button>
</form>
```

Solo `access_key` es obligatorio. Los otros tres son opcionales, agrega
`botcheck` y `_ts` para reforzar la detección de spam, agrega `redirect`
solo para formularios sin JS que necesiten una navegación tras el envío.

## Configuración por formulario (panel)

Estos no se envían con cada solicitud, los estableces una vez por
formulario, desde la pestaña Setup de ese formulario en el
[panel](https://app.formpaste.com) (o mediante la herramienta MCP
[`create_form`](/docs/agents/create-form) para el correo de destino inicial).
Controlan cómo se comporta un formulario en cada envío que recibe.

| Opción                       | Campo                                         | Plan | Notas                                                                                                                                                                                                                                             |
| ---------------------------- | --------------------------------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Correo de destino            | -                                             | Free | A dónde se envían las notificaciones. Debe estar [verificado](/docs/es/first-form#verify-the-destination-email) (OTP) antes de que empiece la entrega.                                                                                                 |
| Dominios permitidos          | `allowed_domains`                             | Free | Lista permitida de orígenes, la verdadera frontera de seguridad detrás de `access_key`. Lista vacía = cualquier origen. Consulta [Lista permitida de dominios](/docs/es/features/custom-domains).                                                      |
| Permitir correos desechables | `allow_disposable_email`                      | Free | Desactivado por defecto; los correos de proveedores desechables se ponen en cuarentena a menos que esto esté activado.                                                                                                                            |
| Asunto de la notificación    | `notification_subject`                        | Free | Línea de asunto personalizada para el correo de notificación. ≤ 200 caracteres.                                                                                                                                                                   |
| Nombre visible del remitente | `sender_name`                                 | Free | Nombre visible desde el que parece venir el correo de notificación. ≤ 100 caracteres.                                                                                                                                                             |
| Mapeo del campo de respuesta | `reply_to_field`                              | Free | Qué campo enviado (por ejemplo `email`) se convierte en el encabezado `Reply-To` de la notificación.                                                                                                                                              |
| Redirección (al enviar)      | `redirect`                                    | Free | Consulta la tabla de campos reservados arriba, se establece por envío, no por formulario, pero la lista permitida que lo controla es a nivel de formulario.                                                                                       |
| Destinatarios adicionales    | `additional_recipients`                       | Pro  | Direcciones adicionales en **To**. Combinado con `cc_recipients`, con un límite de 9 (10 en total con el principal). Cada uno debe verificarse de forma independiente. Consulta [Múltiples destinatarios y CC](/docs/es/features/multiple-recipients). |
| Destinatarios CC             | `cc_recipients`                               | Pro  | Direcciones en CC en la notificación. Mismo límite y regla de verificación que arriba.                                                                                                                                                            |
| Respuesta automática         | `autoresponder_enabled` + campos relacionados | Pro  | Respuesta automática a quien envió el formulario. Consulta [Respuesta automática](/docs/es/features/autoresponder) para la lista completa de campos y salvaguardas.                                                                                    |
| URL de webhook               | `webhook_url`                                 | Pro  | POST HTTPS firmado en cada envío entregado. Consulta [Webhooks](/docs/es/features/webhooks).                                                                                                                                                           |

<Note>
  No hay ningún endpoint de configuración que llamar, estos son ajustes
  exclusivos del panel. El servidor MCP no expone una herramienta
  `update_form`; si necesitas cambiar alguno de estos después de
  `create_form`, hazlo en el panel. Consulta [Servidor
  MCP](/docs/agents/mcp-server#the-three-tools).
</Note>

## Campos Free vs. Pro

Intentar establecer un campo restringido a Pro (`additional_recipients`,
`cc_recipients`, `autoresponder_enabled`, `webhook_url`) en un formulario
del plan Free falla al momento de guardar:

| Código             | HTTP | Significado                        |
| ------------------ | ---- | ---------------------------------- |
| `upgrade_required` | 403  | Esta función requiere un plan Pro. |

<CardGroup cols={2}>
  <Card title="Referencia de errores" icon="triangle-exclamation" href="/docs/es/reference/error-table">
    Cada código de error de `/submit`, estado HTTP, y significado.
  </Card>

  <Card title="Tu primer formulario" icon="inbox" href="/docs/es/first-form">
    El recorrido del panel del que provienen estas opciones.
  </Card>
</CardGroup>