API pública

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.

Autenticación

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.

obtener token
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
200 OK· access_token · expires_in

El token caduca. Cuando la API responda 401, pide otro con la misma llamada.

Primera 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.

node
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

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

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

Cómo empezar

De cero a tu primera llamada autenticada.

  1. Crea una app

    Desde tu panel de cliente, dale un nombre a tu app y actívala. Disponible en el plan Custom.

  2. Obtén tus credenciales

    Un identificador de cliente y un secreto, que puedes rotar cuando quieras desde el panel.

  3. Autentícate

    Usa el flujo de credenciales de cliente para obtener tu token de acceso.

  4. Explora la API

    Consulta la documentación interactiva y revisa cada endpoint disponible.

Referencia

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étodoEndpointPara qué
POST/clients/{id_client}/appsCrear una app dentro de tu cuenta de cliente.
GET/clients/{id_client}/apps/{id_app}/secretConsultar el secreto de la app para poder autenticarte.
GET/organizations/{id_organization}/accountsListar las cuentas conectadas de una organización y su estado.
GET/organizations/{id_organization}/login_linksGenerar los enlaces con los que tu usuario conecta sus redes sin salir de tu producto.
POST/organizations/{id_organization}/uploadsSubir la imagen o el vídeo antes de publicarlo.
POST/organizations/{id_organization}/accounts/{id_account}/publishPublicar o programar en una cuenta concreta.
GET/organizations/{id_organization}/publishConsultar las publicaciones de la organización y en qué estado están.
GET/organizations/{id_organization}/publish/{id_publication}/metricsMétricas de una publicación concreta.
GET/organizations/{id_organization}/accounts/{id_account}/metricsMétricas de la cuenta.
GET/organizations/{id_organization}/limitsConsumo y límites del plan en ese momento.
Webhooks

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.

new_account

Un usuario acaba de conectar una cuenta nueva.

change_state_account

Cambió el estado de una cuenta: se reconectó, caducó su token o dejó de estar disponible.

messages

Entró un mensaje directo en una cuenta conectada.

mentions

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.

Documentación

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.