API pública

Crear una clave API kbs_, llamar a la API REST de Klickbee Social para listar tus cuentas, crear, planificar y publicar publicaciones, y gestionar los errores.

La API REST permite crear y planificar publicaciones desde tus scripts, Zapier, Make, n8n o cualquier otra herramienta. Los asistentes de IA también pueden usar el servidor MCP.

Crear una clave API

Las claves se gestionan en Réglages › API & MCP (Ajustes › API y MCP; sección Développeurs, Desarrolladores), reservado a los Super admins.

Haz clic en Créer une clé (Crear una clave) y dale un Nom (Nombre; por ejemplo « Zapier » o « script interno »).

Copia la clave que aparece. Empieza por kbs_ y no se volverá a mostrar nunca: solo se conserva una huella. Mantenla en secreto, como una contraseña.

Una clave da acceso a todas las marcas del espacio de trabajo: lectura, creación, planificación y publicación de publicaciones. Puedes tener hasta 20 claves activas. La lista indica para cada una su fecha de creación y de último uso.

Révoquer (Revocar) corta inmediata y definitivamente el acceso de los scripts y asistentes que usan la clave. En caso de pérdida, revócala y crea otra.

Autenticarse

GET https://social.klickbee.com/api/v1/brands
Authorization: Bearer kbs_tu_clave

La documentación completa en formato OpenAPI 3.1 es pública: https://social.klickbee.com/api/v1/openapi.json. Impórtala en Postman, Insomnia o tu generador de clientes.

Los endpoints

Método	Ruta	Función
`GET`	`/api/v1/brands`	Listar las marcas.
`GET`	`/api/v1/accounts?brandId=`	Listar las cuentas conectadas de una marca (red, nombre, estado, franjas…).
`GET`	`/api/v1/accounts/{id}/next-slot`	Próxima franja libre de la cola de una cuenta (`null` si los próximos 60 días están llenos).
`GET`	`/api/v1/posts`	Listar las publicaciones (filtros `brandId`, `status`, `from`, `to`, paginación `limit` / `offset`).
`POST`	`/api/v1/posts`	Crear publicaciones: borrador, planificadas, en cola o publicadas de inmediato.
`GET`	`/api/v1/posts/{id}`	Leer una publicación (estado, enlace, error…).
`DELETE`	`/api/v1/posts/{id}`	Eliminar una publicación no publicada.
`POST`	`/api/v1/posts/{id}/schedule`	Planificar o mover una publicación.
`POST`	`/api/v1/posts/{id}/retry`	Reintentar una publicación fallida.
`DELETE`	`/api/v1/posts/{id}/publication`	Retirar una publicación publicada de su red (las mismas redes que en la app).
`POST`	`/api/v1/media`	Importar un medio desde una URL a la mediateca.

Crear una publicación

curl -X POST https://social.klickbee.com/api/v1/posts \
  -H "Authorization: Bearer kbs_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "…",
    "posts": [
      { "platform": "LINKEDIN", "body": "Nuestra nueva guía ya está disponible." },
      { "platform": "THREADS", "body": "Nueva guía disponible 👇" }
    ],
    "schedule": { "queue": true },
    "idempotencyKey": "guide-2026-10"
  }'

posts: de 1 a 20 publicaciones, una por cuenta. Redes: LINKEDIN, THREADS, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE. Indica socialAccountId si la marca tiene varias cuentas en una red.
schedule: ausente = borrador; { "at": "2026-11-02T09:00:00+01:00" } = fecha precisa; { "queue": true } = próxima franja libre; { "now": true } = publicación inmediata.
media: hasta 10 medios por publicación, cada uno con una url pública y su mime (PNG, JPEG, WebP, GIF, PDF, MP4, MOV). Los medios se descargan y se añaden a la mediateca (imágenes y PDF de hasta 15 MB, vídeos de hasta 100 MB).
firstComment: el primer comentario.
TikTok exige settings.privacyLevel para planificar o publicar.
idempotencyKey: reenviar la misma petición con la misma clave no crea duplicados.

Límites y errores

La API acepta 120 peticiones por minuto y por clave. Por encima, responde 429 con una cabecera Retry-After.

Los errores tienen la forma { "error": { "code": "…", "message": "…" } }:

Código	HTTP	Causa
`unauthorized`	401	Clave ausente, desconocida o revocada.
`forbidden`	403 / 402	Acción no autorizada, o espacio de trabajo en solo lectura (402).
`not_found`	404	Marca, cuenta o publicación no encontrada.
`validation_error`	400	Petición no válida (el mensaje indica el campo).
`conflict`	409	Por ejemplo, eliminar una publicación publicada o en curso de publicación.
`media_error`	422	Medio imposible de descargar o formato rechazado.
`rate_limited`	429	Demasiadas peticiones.

Crear una clave API

Autenticarse

Los endpoints

Crear una publicación

Límites y errores

En esta página