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.
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
- En el menú lateral abre API Keys (Claves API).
- Haz clic en Nueva clave.
- Escribe un Nombre descriptivo (por ejemplo, Integración n8n - Ventas). Te ayudará a identificarla más tarde.
- Elige el Workspace sobre el que operará la clave. Este campo es obligatorio: la clave solo podrá leer y escribir datos de ese workspace.
- (Opcional) Selecciona los Scopes (permisos). Si no marcas ninguno, la clave tendrá acceso total. Lo recomendado es marcar solo lo que necesites.
- (Opcional) Define una fecha en Expira el para que la clave caduque sola.
- 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
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.