Inicio Rápido

Esta guía te lleva de una cuenta nueva a tu primera publicación.

1. Regístrate y empieza tu prueba

Regístrate y crea tu organización. Cada cuenta empieza con una prueba gratis de 7 días mediante el proceso de pago de Stripe.

2. Conecta tus cuentas sociales

Desde el panel, conecta las cuentas en las que quieres publicar: cuentas profesionales de Instagram (Business o Creator) y cuentas de X. Cada conexión pasa por el flujo OAuth de la propia plataforma, e InvisibleAPI mantiene los tokens renovados por ti.

3. Crea una clave de API

Genera una clave de API de organización desde el panel. Las claves tienen ámbitos limitados (publishing:read, publishing:publish), se muestran una sola vez y son revocables. Mantén el token en secreto: autoriza la publicación en tus cuentas conectadas.

4. Crea tu primer trabajo de publicación

Envía una petición con tu clave de API en la cabecera Authorization:

POST /api/v1/organizations/{organization}/publishing/jobs

{
  "targets": ["3f2a9c10-8b41-4e7d-9c22-5a1e6b0d7f33"],
  "mediaItems": [
    {
      "mediaType": "image",
      "sourceUrl": "https://cdn.example.com/launch.jpg",
      "altText": "The new release, photographed on a desk"
    }
  ],
  "caption": "New drop, live now.",
  "clientRequestId": "first-publish-test"
}

targets acepta al menos un ID de cuenta conectada. mediaItems admite hasta 10 elementos, cada uno con un mediaType de image o video y una sourceUrl públicamente accesible: no hay endpoint de subida, así que un enlace a un bucket privado es la causa más común de que falle una primera publicación. caption y firstComment aceptan hasta 5000 caracteres. requestedPublishAt es opcional y arriba se omite para que la publicación salga de inmediato. Añádelo, como marca de tiempo ISO-8601 en el futuro, para programarla. clientRequestId admite hasta 128 caracteres y hace seguro un reintento: el mismo ID con la misma carga devuelve el trabajo original en lugar de publicar dos veces.

La llamada devuelve 202, no una publicación ya creada. La publicación es asíncrona, así que consulta el trabajo hasta que llegue a un estado final:

GET /api/v1/organizations/{organization}/publishing/jobs/{publishJobId}

Un trabajo pasa por pending, scheduled, processing, preparing, submitted y polling antes de quedar en uno de estos: published, partial_failure, failed, action_required o canceled.

5. Automatiza

Cuando salga tu primera publicación, puedes:

• Publicar directamente desde tu propia aplicación o script
• Apuntar Claude (o cualquier agente compatible con MCP) al servidor MCP de InvisibleAPI y dejar que redacte y programe publicaciones
• Estar atento a las integraciones con n8n y Zapier y a la CLI, que llegarán próximamente

Explora la biblioteca de plantillas para encontrar recetas listas para usar.