• Inicio
  • Guía de Integración
Guía de Integración

Upload-Post + n8n Integration

Automate your social media publishing by connecting Upload-Post with n8n. Start by setting up your Upload-Post users and API key, then choose between our official n8n node or manual HTTP configuration.

Browse All n8n Templates

¿Necesitas ayuda para construir tu flujo de trabajo? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Contact us

Prerequisite: Setup in Upload-Post

Before configuring n8n, you must set up users and generate an API key within your Upload-Post account. These will be used to authenticate and direct your automated posts.

Manage Users & Connect Social Accounts

Each post is associated with a specific user in Upload-Post. This user must have the target social media platforms connected to their profile.

  • Navega a la Manage Users página en tu panel de Upload-Post.
  • Agrega un nuevo usuario o selecciona uno existente.
  • Para el usuario elegido, conecta todas las cuentas de redes sociales (por ejemplo, TikTok, Instagram, Facebook) a las que pretendes publicar contenido a través de n8n.
  • Toma nota del Identificador del usuario (esto es típicamente el nombre de usuario o un ID único asociado al usuario en Upload-Post). Lo necesitarás para tu n8n workflows.

Importante: Las cuentas sociales deben estar conectadas al *usuario específico* que pretendes usar en tu automatización, no solo de forma general a your Upload-Post account.

Generar Clave API

The API key authenticates your requests to the Upload-Post API.

  • Ve a la Claves de API page in your Upload-Post API keys section.
  • Generar una nueva clave API si no tienes una ya.
  • Copia esta clave API de forma segura. La usarás en la configuración de credenciales de n8n.

Nota de Seguridad: Trata tu clave API como una contraseña. No la compartas públicamente ni la incrustes directamente en flujos compartidos. Usa la gestión de credenciales de n8nial management system.

Once you have your Identificador del usuario and Clave de API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Disponibilidad del nodo:

The n8n-nodes-upload-post el nodo está incluido por defecto en las versiones actualizadas de n8n tanto para self-hosted (on-premise) n8n instances and n8n cloud instances. No manual installation is required - just ensure you have the latest version of n8n.

The easiest way to integrate is using our official node: n8n-nodes-upload-post. This node is included by default in updated versions of n8n and streamlines setup with dedicated operations for both cloud and self-hosted n8n instances.

1. Accede al Nodo Upload-Post

El nodo de Upload-Post está incluido por defecto en las versiones actualizadas de n8n:

  1. Asegúrate de tener instalada la última versión de n8n.
  2. Abre tu editor de flujos de trabajo n8n.
  3. Busca "Upload Post" en la biblioteca de nodos.
  4. El nodo debería estar disponible sin ninguna instalación adicional.

If you don\'t see the node, please update your n8n instance to the latest version.

2. Configure Upload-Post API Credentials in n8n

You\'ll use the API Key generated from your Sección de la API de Subida de Publicaciones (as described in the "Prerequisite" section above).

  1. En n8n, ve a Credenciales > Nuevo.
  2. Search for API de Subida de Publicaciones y selecciónalo.
  3. Assign a memorable Nombre de Credencial (e.g., "My Upload-Post API Key").
  4. Pega tu Upload Post Clave de API en el campo designado.
  5. Click Guardar.

Esto almacena de forma segura tu clave API para su uso por el nodo de Upload-Post.

3. Utilize Node Operations in Your Flujos de Trabajo

The node provides dedicated operations. For each, you will need to provide the Identificador del usuario (del usuario que configuraste en Gestionar usuarios de Upload-Post) to specify which user\'s social accounts to use.

Subir Foto(s)

Sube una o más fotos. Acepta archivos o URLs.

Requerido: User Identifier, Platform(s), Photos. Opcional: Title, Caption. Platform-specific fields available.

Subir Video

Sube un solo video. Acepta archivo o URL.

Requerido: User Identifier, Platform(s), Video. Opcional: Title. Platform-specific fields available.

Subir Texto

Sube una publicación basada en texto.

Requerido: User Identifier, Platform(s), Title/Content. Platform-specific fields available.

Consulta la node\'s help documentation within n8n or the npm package page para listas detalladas de parámetros. El Documentación de la API de Subida de Publicaciones provides full details on underlying API capabilities.

Using this dedicated n8n node is the recommended approach for both cloud and self-hosted n8n users.

Manual Configuration (Alternative using HTTP Request Node)

If the official node is not suitable for your specific needs, you can configure the integration manually using n8n\'s generic HTTP Request node. This requires careful setup of API parameters.

Requisito previo: Usuario de Upload-Post y clave API

Asegúrate de haber completado los pasos de "Requisito: Configuración en Upload-Post" descritos al principio de esta guía. Necesitarás:

Open Upload-Post App

Entendiendo los endpoints de la API de Upload-Post y haciendo solicitudes

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Autorización con tu clave API y generalmente requieren un user campo (tu Identificador de Usuario de Upload-Post) y platform[] to specify the target social media.

1. Video Upload Endpoint

Endpoint URL: https://api.upload-post.com/api/upload

Usa este endpoint para subir archivos de video individuales. Los parámetros clave incluyen video (file), title, user, and platform[].

curl \
  -H 'Autorización: Apikey TU_CLAVE_API_AQUÍ' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Tu Título de Video"' \
  -F 'user="TU_IDENTIFICADOR_DE_USUARIO"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

Endpoint URL: https://api.upload-post.com/api/upload_photos

Para subir una o más fotos (por ejemplo, para carruseles/presentaciones). Usa photos[] para cada archivo de imagen. También incluye user, platform[], title, and optionally description.

curl \
  -H 'Autorización: Apikey TU_CLAVE_API_AQUÍ' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="TU_IDENTIFICADOR_DE_USUARIO"' \
  -F 'platform[]=instagram' \
  -F 'title="My Awesome Photo Album"' \
  -F 'description="Check out these cool photos!"' \
  -X POST https://api.upload-post.com/api/upload_photos

3. Text Upload Endpoint

Endpoint URL: https://api.upload-post.com/api/upload_text

For publishing text-based posts. Requires user, platform[], and title (como contenido principal). caption puede usarse para seguimiento interno o necesidades específicas de la plataforma.

curl \
  -H 'Autorización: Apikey TU_CLAVE_API_AQUÍ' \
  -F 'user="TU_IDENTIFICADOR_DE_USUARIO"' \
  -F 'platform[]=x' \
  -F 'title="This is my amazing tweet content!"' \
  -F 'caption="Optional: A caption for stats & tracking."' \
  -X POST https://api.upload-post.com/api/upload_text

Notas Importantes para la Configuración Manual:

  • Replace TU_CLAVE_API_AQUÍ con tu clave API real de la sección API de Upload-Post.
  • Replace TU_IDENTIFICADOR_DE_USUARIO con el Identificador de Usuario específico (por ejemplo, nombre de usuario) de Upload-Post que tiene las cuentas de redes sociales objetivo conectadas.
  • Se recomienda encarecidamente almacenar tu clave API en el administrador de credenciales de n8n y hacer referencia a ella en tu nodo de Solicitud HTTP en lugar de codificarla directamente.
  • The @/path/to/your/file la sintaxis en cURL indica una subida de archivo. En n8n, usarías expresiones para referenciar datos binarios de nodos anteriores (e.g., ={{ $binary.data }}).

Consejo profesional: Prueba y genera cURL desde el panel de Upload-Post

Before configuring n8n, test your uploads directly from the Panel de control de Upload-Post. Once you\'ve successfully uploaded content, the dashboard generates a perfect cURL command that you can copy and import directly into your n8n HTTP Request node.

Flujo de Trabajo:

  1. Ve a Panel de control de Upload-Post
  2. Sube tu contenido (video, fotos o texto) a las plataformas que desees
  3. Después de una carga exitosa, copia el comando cURL generado
  4. Importa este cURL directamente en tu nodo de Solicitud HTTP de n8n utilizando la función "Importar desde cURL"

Configura el Nodo de Solicitud HTTP de n8n (Cuerpo)

Key fields for the HTTP Request node\'s body (typically multipart/form-data):

Campo Valor / Descripción Requerido
user Your Identificador del usuario de Upload-Post (por ejemplo, nombre de usuario). Requerido
platform[] Platform identifier (e.g., tiktok, instagram). Repeat for multiple platforms. Requerido
title Título o contenido de la publicación (varía según la plataforma y el tipo de publicación). Opcional/Varía
video Datos de archivo binario para cargas de video. Si subiendo video
image[] Datos de archivo binario para cargas de imágenes. Repite para múltiples imágenes en un carrusel/presentación. Si subiendo imagen(es)
n8n Configuration Tips:
  • Set HTTP Request node Método to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Autorización con tu clave API.
  • For Tipo de contenido del cuerpo, select multipart/form-data.
  • Añade campos al cuerpo como user, platform[], title, and either video or image[] with appropriate values (e.g., using n8n expressions like ={{ $binary.data }} for file data).

For detailed examples and platform-specific parameters, refer to the Documentación de la API de Subida de Publicaciones.

Ejemplo: Nodo HTTP JSON (Video a TikTok)

This is a conceptual JSON representation for an n8n HTTP Request node configured to upload a video to TikTok. You would build this using the n8n interface. 

{
  "parameters": {
    "method": "POST",
    "url": "https://api.upload-post.com/api/upload",
    "authentication": "headerAuth",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        {
          "name": "Autorización",
          "value": "Apikey YOUR_API_KEY_HERE"
        }
      ]
    },
    "sendBody": true,
    "bodyContentType": "multipart-form-data",
    "bodyParameters": {
      "parameters": [
        {
          "name": "user",
          "value": "YOUR_UPLOAD_POST_USER_IDENTIFIER"
        },
        {
          "name": "title",
          "value": "= $input.item.title ? $input.item.title : 'Mi increíble video'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Subir Video a TikTok (Manual)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • Seguridad de la Clave de API: Usa siempre la gestión de credenciales de n8n para tu clave API de Upload-Post. Evita escribirla directamente en el código.
  • Identificador del usuario: Ensure the user el campo en el cuerpo de tu solicitud referencia correctamente el Identificador de Usuario de Upload-Post cuyas cuentas sociales conectadas tú intend to use.
  • Al compartir flujos de trabajo, exporta sin datos de credenciales sensibles.

Ejemplo de Flujo de Trabajo: Publicador de Redes Sociales Potenciado por IA

This workflow is available as a template: Ver en n8n.io o ver todas nuestras plantillas de n8n

What It Does

  • Monitorea una carpeta de Google Drive en busca de nuevos videos
  • Transcribe el video usando OpenAI
  • Genera descripciones atractivas para redes sociales
  • Cargas a Instagram, TikTok y YouTube
  • Envía notificaciones al completar o en caso de errores

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Disparador de Google Drive: Configura para monitorear una carpeta específica para nuevos videos
  2. Transcripción de OpenAI: Configura para extraer audio y convertir a texto
  3. Generador de Descripciones de OpenAI: Use a custom prompt to create engaging descriptions based on transcription
  4. Solicitud HTTP de Upload-Post: Configure as described in previous steps with multi-platform selection
  5. Manejo de Errores: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Ejemplo de Flujo de Trabajo: Publicador de Carruseles de Imágenes para Instagram y TikTok

This workflow is available as a template: Ver en n8n.io o ver todas nuestras plantillas de n8n

What It Does

  • Automatiza la subida de múltiples imágenes como carruseles a Instagram
  • Automatiza la subida de múltiples imágenes como presentaciones a TikTok
  • Optimiza la gestión de contenido visual en todas las plataformas
  • Maneja cargas de múltiples imágenes con un solo disparador

Workflow Steps

  1. Disparador: Inicia el flujo de trabajo con tus imágenes seleccionadas (por ejemplo, desde un horario, webhook o ejecución manual).
  2. Procesamiento de imágenes: El flujo de trabajo prepara las imágenes para formatos específicos de cada plataforma (considera nodos para redimensionar o formatear si es necesario).
  3. Solicitud HTTP de Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Usa el campo `image[]` en lugar de `video`.
    • Pasa datos binarios para cada imagen al campo `image[]`.
    • Establece `platform[]` en `instagram` y/o `tiktok`.
  4. Optimización de la plataforma: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Añade nodos para notificar en caso de éxito o fallo.

Consulta la n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

¿Necesitas ayuda?

Nuestros expertos en integración están aquí para ayudar

Contact Support