KuikCodeDocs
KuikLinks

API, Zapier y asistentes de IA

Crea y administra KuikLinks desde tus propios sistemas con la API, desde Zapier o pidiéndoselo a un asistente de IA.

Todo lo que haces con los KuikLinks en el panel también se puede hacer desde fuera. La API y Zapier están incluidos desde PRO; los asistentes de IA (MCP) están incluidos en Business.

API

Los links tienen su propio recurso, /links, junto a /codes. Envía tu clave de API como bearer token, igual que en cada llamada; consulta Autenticación.

curl https://api.kuikcode.com/v1/links \
  -H "Authorization: Bearer kc_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f1c2a9e-oferta-primavera" \
  -d '{
    "url": "https://example.com/oferta-primavera",
    "name": "Oferta de primavera",
    "slug": "oferta-primavera",
    "tags": ["campaña"],
    "utm": { "source": "newsletter", "medium": "email" }
  }'

La respuesta trae la dirección para compartir en shortUrl:

{
  "id": "L7c2Qp9XrT4vBn81ZsKdE",
  "name": "Oferta de primavera",
  "url": "https://example.com/oferta-primavera",
  "shortUrl": "https://kuik.sh/oferta-primavera",
  "state": "ok",
  "clicks": 0
}
LlamadaQué hace
GET /linksLista los links. Filtra con q, folderId, tag, tenantId o externalId
POST /linksCrea un link
GET /links/{id}Lee un link
PATCH /links/{id}Cambia un link. Envía solo los campos que cambian
DELETE /links/{id}Elimina un link
POST /links/bulkCrea muchos links, todos o ninguno. dryRun: true solo revisa
POST /links/{id}/codeCrea un KuikCode que abre el link
GET /scans?kind=linkLee los clics. Agrega linkId para un solo link
POST /track/lead, POST /track/saleReporta un lead o una venta para un clic. Consulta Seguimiento de conversiones

Lo que conviene saber:

  • Una dirección rechazada responde 422 con el código url_refused. El message dice por qué: la dirección está mal formada, es otro link corto o aparece en una lista de sitios no seguros. Los demás errores funcionan como en el resto de la API; consulta Errores.
  • state te dice si un link está activo. ok está activo. review y flagged están activos detrás de una página de aviso. blocked no redirige. Consulta Seguridad.
  • externalId es tu propio id para un link, único en el espacio de trabajo. Úsalo para encontrar un link que creaste desde tu sistema: GET /links?externalId=pedido-10432.
  • Los límites del plan aplican igual que en el panel: los links por mes, los finales legibles desde Core, el vencimiento desde PRO. Un rechazo responde 403 y nombra el límite.
  • Los clics y los escaneos nunca se mezclan. GET /scans y las llamadas de analíticas leen escaneos de KuikCodes, salvo que envíes kind=link. En un clic, via es qr cuando la visita llegó por el KuikCode del link.
  • Envía un encabezado Idempotency-Key en cada POST para que un reintento nunca cree un segundo link; consulta Idempotencia.

Zapier

La app de KuikCode para Zapier tiene tres pasos para links:

PasoQué hace
New Short Link Click (disparador)Inicia un Zap cuando alguien abre uno de tus links, o el link que elijas
Create Short Link (acción)Crea un link y devuelve la dirección corta
Find Short Link (búsqueda)Encuentra un link por su destino, nombre o final, y puede crearlo cuando ninguno coincide

Conecta tu espacio de trabajo como se explica en App de KuikCode para Zapier.

Asistentes de IA

Con el servidor MCP conectado, un asistente puede trabajar con tus links en palabras simples: "acorta este link y llámalo Oferta de primavera", "apunta el link del newsletter a la página nueva", "cuántos clics tuvo el link de la bio esta semana", "haz un código QR para ese link".

Puede listar, leer, crear y actualizar links, crear un KuikCode para un link y leer los clics. No puede eliminar un link.

En esta página