API Tutorial
Cómo publicar en Pinterest por API
Para publicar en Pinterest por API, conecta la cuenta de Pinterest a través de Modiva (que se encarga de OAuth y los scopes) y luego llama a la herramienta `posts_create` con tu texto y tus medios — Modiva lo publica en Pinterest y devuelve el ID de la publicación.
La propia API de Pinterest exige revisión de la app, gestión de OAuth y los permisos de publicación correctos antes de que puedas publicar siquiera una actualización. Modiva se ocupa de todo eso por ti y expone una única herramienta `posts_create` que publica en Pinterest (y en cualquier otra plataforma conectada) de la misma manera.
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_create para publicar en Pinterest
Llama a la herramienta `posts_create` con el ID de conexión y tu contenido. Modiva valida el payload frente a las reglas de formato de Pinterest (longitud, tipos de medios, relaciones de aspecto) y publica al instante, devolviendo el ID y la URL de la publicación en vivo.
Haz más — programa, publica de forma cruzada, automatiza
La misma llamada impulsa a un agente de IA a través de MCP: apunta a Claude o Cursor a `https://mcp.modiva.ai/v1` y podrá publicar en Pinterest en tu nombre. Cambia `posts_create` por `posts_schedule` para ponerlo en cola, o `posts_cross_post` para difundir una publicación a todas las plataformas de una vez.
Solicitud de ejemplo
Llama a la herramienta posts_create 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_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Pruébalo con Pinterest
Empieza gratisPreguntas frecuentes
¿Necesito una app de desarrollador de Pinterest para publicar por API?
No. Modiva posee la app de Pinterest ya revisada y se encarga de OAuth, así que te conectas con un clic y empiezas — sin revisión de la app, sin lidiar con scopes.
¿Puede un agente de IA publicar en Pinterest por mí?
Sí. La misma herramienta `posts_create` se expone a través del Model Context Protocol, de modo que cualquier cliente MCP (Claude, Cursor, etc.) puede publicar en Pinterest en cuanto añadas tu clave MCP de Modiva.