API Tutorial
Cómo programar publicaciones de Pinterest por API
Para programar publicaciones de Pinterest por API, conecta Pinterest a través de Modiva y luego llama a `posts_schedule` con tu contenido y una marca de tiempo `publish_at` — Modiva lo pone en cola y lo publica automáticamente en Pinterest a esa hora.
Programar significa guardar una publicación y publicarla más tarde de forma fiable — algo que la API de Pinterest deja enteramente en tus manos. Modiva opera la cola, reintenta ante errores transitorios de Pinterest y expone una única herramienta `posts_schedule` que funciona igual en cualquier plataforma.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de Pinterest
En el panel, haz clic en Conectar y elige Pinterest. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de Pinterest. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_schedule con una hora publish_at
Llama a `posts_schedule` con el ID de conexión, tu contenido y una marca de tiempo `publish_at` en formato ISO. Modiva guarda el trabajo y publica en Pinterest a esa hora, encargándose de la renovación de tokens y los reintentos sin que tengas tu propio cron.
Encuentra el mejor momento y agrupa un calendario
Llama a `analytics_best_time_to_post` para elegir una franja horaria y luego programa una semana entera en un bucle. A través de MCP, un agente de IA puede planificar y poner en cola un calendario de contenido completo de Pinterest a partir de un solo prompt.
Solicitud de ejemplo
Llama a la herramienta posts_schedule a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Pruébalo con Pinterest
Empieza gratisPreguntas frecuentes
¿El programador lo opera Modiva o yo?
Modiva. En cuanto llamas a `posts_schedule`, Modiva guarda el trabajo y publica en Pinterest a la hora deseada — no necesitas tu propia cola ni cron.
¿Puedo programar la misma publicación para varias plataformas?
Sí — pasa varios ID de conexión (o usa `posts_cross_post`) y Modiva programa la publicación para Pinterest y para cualquier otra plataforma, adaptada al formato de cada una.