Crear una clave API personal (PAT)

Aprende a generar tu primera clave API personal en Omnifox para conectar integraciones, scripts o herramientas externas a tu workspace.

Jun 26, 2026

Mira este paso en el video · Crear una clave API

Una clave API personal (PAT, Personal Access Token) es una credencial que permite que aplicaciones externas (n8n, Zapier, tus propios scripts) accedan a Omnifox en tu nombre, sin compartir tu usuario y contraseña. Cada clave se emite para un workspace específico y puede limitarse a determinados permisos.

Requisitos

  • Tu plan debe incluir Acceso por API (disponible desde los planes superiores). Si no lo tienes activo, verás un aviso para mejorar tu plan.
  • Necesitas el permiso Claves API: gestionar (los administradores lo tienen por defecto).
  • Pertenecer al workspace para el que vas a emitir la clave.

Pasos

  1. En el menú lateral abre API Keys (Claves API).
  2. Haz clic en Nueva clave.
  3. Escribe un Nombre descriptivo (por ejemplo, Integración n8n - Ventas). Te ayudará a identificarla más tarde.
  4. Elige el Workspace sobre el que operará la clave. Este campo es obligatorio: la clave solo podrá leer y escribir datos de ese workspace.
  5. (Opcional) Selecciona los Scopes (permisos). Si no marcas ninguno, la clave tendrá acceso total. Lo recomendado es marcar solo lo que necesites.
  6. (Opcional) Define una fecha en Expira el para que la clave caduque sola.
  7. Haz clic en Guardar.

Verificación

Al guardar aparece una ventana "Copia y guarda ahora" con la clave completa. Tiene este formato: 123_aBc... y un prefijo visible como omf_1a2b.

Esta es la única vez que se muestra la clave completa. Cópiala con el botón Copiar y guárdala en un gestor de contraseñas. Después de cerrar la ventana solo verás el prefijo.

Cierra la ventana con Entendido. La nueva clave aparecerá en el listado de API Keys con su nombre, workspace y prefijo.

Si no funciona

  • Veo un aviso de plan (error 402): tu plan no incluye Acceso por API. Mejora el plan desde Facturación.
  • No veo la opción API Keys en el menú: te falta el permiso api-keys.view. Pídele a un administrador que te lo asigne.
  • No me deja elegir un workspace: solo aparecen los workspaces a los que perteneces. Pide que te agreguen al workspace correcto.
  • Perdí la clave: no se puede recuperar. Borra la anterior y crea una nueva (o usa Regenerar).

Tips

  • Usa un nombre por integración: si una se ve comprometida, la borras sin afectar a las demás.
  • Para integraciones automáticas (no para ti como agente humano), marca Token de servicio (bot) al crearla.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp