Construye sobre PlanVortex
Conecta tus propias apps a PlanVortex: publica contenido, sincroniza analíticas y recibe eventos en tiempo real con la misma API que usa nuestro propio panel.
Crear apps propias y usar la API va en el plan Custom. El resto de planes se usan desde el panel.
Credenciales de cliente, sin sesión de usuario
Cada app que creas tiene su identificador y su secreto. Pides un token con el flujo de client credentials y llamas: sin cookies, sin usuario intermedio y sin renovar OAuth red por red. La URL de tu realm aparece en el panel, junto a las credenciales.
curl -X POST "$PLANVORTEX_AUTH_URL/protocol/openid-connect/token" \ -d grant_type=client_credentials \ -d client_id=$APP_CLIENT_ID \ -d client_secret=$APP_SECRET
El token caduca. Cuando la API responda 401, pide otro con la misma llamada.
Publicar en unas pocas líneas
Eliges la cuenta y la red de destino, mandas el texto y los ficheros que hayas subido antes, y PlanVortex se encarga del resto. Si añades una fecha de publicación, queda programada en vez de salir al momento.
const res = await fetch(`${API}/organizations/${org}/accounts/${acc}/publish`, { method: "POST", headers: { Authorization: `Bearer ${token}` }, body: JSON.stringify({ social_network: "instagram", text: "Nuevo horno, nuevas hogazas", files: ["66f1a2b3c4d5e6f7a8b9c0d1"], publish_date: "2026-09-01T10:00:00.000Z" }) });
Para quién es
Pensada para quien ya construye algo propio y quiere que las redes sociales vivan dentro de ello.
Agencias
Centraliza la gestión de tus clientes en tu propio panel interno, sin que tengan que entrar a PlanVortex.
Plataformas y SaaS
Añade publicación y analíticas de redes sociales a tu producto sin construirlas desde cero.
Equipos de producto
Conecta PlanVortex a tu stack interno: BI, CRM, automatizaciones.
Casos de uso
Lo que ya se puede automatizar hoy con la API.
Publicar y programar
Crea, programa y publica contenido en las redes conectadas, por código.
Sincronizar analíticas
Trae las métricas de cada cuenta y publicación a tu propio panel.
Webhooks en tiempo real
Recibe eventos al momento cuando cambian cuentas, mensajes o publicaciones — sin hacer polling.
Conexión embebida
Deja que tus usuarios conecten sus redes sociales sin salir de tu producto.
Cómo empezar
De cero a tu primera llamada autenticada.
Crea una app
Desde tu panel de cliente, dale un nombre a tu app y actívala. Disponible en el plan Custom.
Obtén tus credenciales
Un identificador de cliente y un secreto, que puedes rotar cuando quieras desde el panel.
Autentícate
Usa el flujo de credenciales de cliente para obtener tu token de acceso.
Explora la API
Consulta la documentación interactiva y revisa cada endpoint disponible.
Los endpoints que vas a usar el primer día
Todos cuelgan de la misma base y se autentican con la cabecera Authorization: Bearer. La referencia completa, con cada parámetro y sus respuestas de ejemplo, está en la documentación.
URL basehttps://api.planvortex.com/v1.0.0
| Método | Endpoint | Para qué |
|---|---|---|
| POST | /clients/{id_client}/apps | Crear una app dentro de tu cuenta de cliente. |
| GET | /clients/{id_client}/apps/{id_app}/secret | Consultar el secreto de la app para poder autenticarte. |
| GET | /organizations/{id_organization}/accounts | Listar las cuentas conectadas de una organización y su estado. |
| GET | /organizations/{id_organization}/login_links | Generar los enlaces con los que tu usuario conecta sus redes sin salir de tu producto. |
| POST | /organizations/{id_organization}/uploads | Subir la imagen o el vídeo antes de publicarlo. |
| POST | /organizations/{id_organization}/accounts/{id_account}/publish | Publicar o programar en una cuenta concreta. |
| GET | /organizations/{id_organization}/publish | Consultar las publicaciones de la organización y en qué estado están. |
| GET | /organizations/{id_organization}/publish/{id_publication}/metrics | Métricas de una publicación concreta. |
| GET | /organizations/{id_organization}/accounts/{id_account}/metrics | Métricas de la cuenta. |
| GET | /organizations/{id_organization}/limits | Consumo y límites del plan en ese momento. |
Eventos que te enviamos
Pones una URL en tu app y PlanVortex hace un POST ahí cuando pasa algo en las cuentas conectadas. Cada envío va firmado con el secreto de la app, para que puedas comprobar que viene de nosotros.
Un usuario acaba de conectar una cuenta nueva.
Cambió el estado de una cuenta: se reconectó, caducó su token o dejó de estar disponible.
Entró un mensaje directo en una cuenta conectada.
Alguien ha mencionado a una de tus cuentas.
Versionado
La versión va en la ruta. Mientras siga ahí, lo que hoy te funciona seguirá funcionando igual.
Firma de los webhooks
Cada POST lleva las cabeceras x-hub-signature y x-hub-signature-256 calculadas con el secreto de tu app. Compruébalas antes de procesar el cuerpo.
Documentación interactiva
Referencia OpenAPI por áreas —cuentas, publicaciones, subidas, organizaciones, roles y planes de IA— con cada parámetro y su respuesta de ejemplo.
Toda la API, documentada
Endpoints, parámetros y respuestas de ejemplo — con la misma paleta y tipografía de PlanVortex, para que no se sienta como salir del sitio.