Integratiehandleiding

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

Heb je hulp nodig bij het bouwen van je workflow? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Neem contact op

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.

Beheer Gebruikers & Verbind Sociale 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.

  • Navigate to the Beheer Gebruikers page in your Upload-Post dashboard.
  • Voeg een nieuwe gebruiker toe of selecteer een bestaande.
  • Verbind voor de gekozen gebruiker alle sociale media-accounts (bijv. TikTok, Instagram, Facebook) waarmee je van plan bent inhoud te publiceren via n8n.
  • Take note of the Gebruikersidentificator (this is typically the username or a unique ID associated with the user in Upload-Post). You will need this for your n8n workflows.

Belangrijk: De sociale accounts moeten verbonden zijn met de *specifieke gebruiker* die je wilt gebruiken in je automatisering, niet alleen algemeen met je Upload-Post account.

Genereer API-sleutel

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

  • Go to the API Sleutels page in your Upload-Post API keys section.
  • Genereer een nieuwe API-sleutel als je er nog geen hebt.
  • Kopieer deze API-sleutel veilig. Je zult deze gebruiken in je n8n-credentialinstellingen.

Beveiligingsopmerking: Treat your API key like a password. Do not share it publicly or embed it directly in shared workflows. Use n8n\'s credential management system.

Once you have your Gebruikersidentificator and API Sleutel from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Node Beschikbaarheid:

The n8n-nodes-upload-post node is now included by default in updated versions of n8n for both 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. Access the Upload-Post Node

De Upload-Post node is standaard inbegrepen in bijgewerkte versies van n8n:

  1. Zorg ervoor dat je de nieuwste versie van n8n hebt geïnstalleerd.
  2. Open je n8n workflow-editor.
  3. Zoek naar "Upload Post" in de node-bibliotheek.
  4. De node moet beschikbaar zijn zonder extra installatie.

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 Upload Post API Sectie (as described in the "Prerequisite" section above).

  1. In n8n, go to Referenties > Nieuw.
  2. Search for Upload Post API en selecteer het.
  3. Assign a memorable Referentienaam (e.g., "My Upload-Post API Key").
  4. Plak je Upload Post API Sleutel in het aangewezen veld.
  5. Click Opslaan.

Dit slaat je API-sleutel veilig op voor gebruik door de Upload-Post-node.

3. Utilize Node Operations in Your Werkstromen

The node provides dedicated operations. For each, you will need to provide the Gebruikersidentificator (from the user you set up in Upload-Post Beheer Gebruikers) to specify which user\'s social accounts to use.

Upload Foto('s)

Upload één of meer foto\'s. Accepteert bestanden of URL\'s.

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

Upload Video

Upload een enkele video. Accepteert bestand of URL.

Vereist: User Identifier, Platform(s), Video. Optioneel: Title. Platform-specific fields available.

Upload Tekst

Upload een tekstgebaseerde post.

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

Refer to the node\'s help documentation within n8n or the npm package page for detailed parameter lists. The Upload Post API Documentatie 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.

Vereiste: Upload-Post gebruiker & API-sleutel.

Zorg ervoor dat je de stappen "Vereiste: Setup in Upload-Post" hebt voltooid zoals beschreven aan het begin van deze gids. Je hebt nodig:

Open Upload-Post App

Begrijpen van Upload-Post API Eindpunten & Verzoeken Indienen

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Autorisatie header with your API Key and generally require a user field (your User Identifier from Upload-Post) and platform[] to specify the target social media.

1. Video Upload Endpoint

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

Use this endpoint for uploading single video files. Key parameters include video (file), title, user, and platform[].

curl \
  -H 'Autorisatie: Apikey JOUW_API_SLEUTEL_HIER' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Je videotitel"' \
  -F 'user="JOUW_GEBRUIKERSIDENTIFICATOR"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

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

For uploading one or more photos (e.g., for carousels/slideshows). Use photos[] for each image file. Also include user, platform[], title, and optionally description.

curl \
  -H 'Autorisatie: Apikey JOUW_API_SLEUTEL_HIER' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="JOUW_GEBRUIKERSIDENTIFICATOR"' \
  -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

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

For publishing text-based posts. Requires user, platform[], and title (as the main content). caption can be used for internal tracking or specific platform needs.

curl \
  -H 'Autorisatie: Apikey JOUW_API_SLEUTEL_HIER' \
  -F 'user="JOUW_GEBRUIKERSIDENTIFICATOR"' \
  -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

Belangrijke notities voor handmatige configuratie:

  • Replace JOUW_API_SLEUTEL_HIER with your actual API key from the Upload-Post Api section.
  • Replace JOUW_GEBRUIKERSIDENTIFICATOR met de specifieke Gebruikersidentificator (bijv. gebruikersnaam) van Upload-Post die de doelaccounts voor sociale media gekoppeld heeft.
  • Het wordt sterk aanbevolen om je API-sleutel op te slaan in de referentiebeheerder van n8n en deze te verwijzen in je HTTP Request-node in plaats van hardcoded.
  • The @/path/to/your/file syntax in cURL indicates a file upload. In n8n, you would use expressions to reference binary data from previous nodes (e.g., ={{ $binary.data }}).

Pro Tip: Test & Genereer cURL vanuit het Upload-Post Dashboard.

Before configuring n8n, test your uploads directly from the Upload-Post Dashboard. 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.

Workflow:

  1. Go to Upload-Post Dashboard
  2. Upload je inhoud (video, foto\'s of tekst) naar de gewenste platforms
  3. Na succesvolle upload, kopieer de gegenereerde cURL-opdracht
  4. Importeer deze cURL rechtstreeks in je n8n HTTP Request-node met de functie "Importeer van cURL"

Configureer n8n HTTP Verzoeknode (Body)

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

Veld Waarde / Beschrijving Vereist
user Your Gebruikersidentificator from Upload-Post (e.g., username). Vereist
platform[] Platform-identificator (bijv. tiktok, instagram). Repeat for multiple platforms. Vereist
title Post titel of inhoud (verschilt per platform en type post). Optioneel/Variabel
video Binaire bestandsgegevens voor video-upload. Als je video uploadt
image[] Binaire bestandsgegevens voor het uploaden van afbeeldingen. Herhaal voor meerdere afbeeldingen in een carrousel/slideshow. Als je afbeelding(en) uploadt
n8n Configuration Tips:
  • Set HTTP Request node Methode to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Autorisatie header with your API key.
  • For Inhoudstype, select multipart/form-data.
  • Voeg velden toe aan de body zoals 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 Upload Post API Documentatie.

Voorbeeld: HTTP Node JSON (Video naar 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": "Autorisatie",
          "value": "Apikey JOUW_API_KEY_HIER"
        }
      ]
    },
    "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 : 'Mijn geweldige video'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Upload Video naar TikTok (Handmatig)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • API Sleutel Beveiliging: Always use n8n\'s credential management for your Upload-Post API Key. Avoid hardcoding it.
  • Gebruikersidentificator: Zorg ervoor dat het user veld in je verzoekbody correct verwijst naar de Gebruikersidentificator van Upload-Post waarvan je de gekoppelde sociale accounts wilt gebruiken.
  • Wanneer je workflows deelt, exporteer zonder gevoelige inloggegevens.

Voorbeeldworkflow: AI-gestuurde social media uitgever

This workflow is available as a template: Bekijk op n8n.io or see all our n8n templates

What It Does

  • Monitort een Google Drive-map op nieuwe video\'s
  • Transcribeert de video met OpenAI
  • Genereert boeiende sociale media beschrijvingen
  • Uploads naar Instagram, TikTok & YouTube
  • Verzendt meldingen bij voltooiing of fouten

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Google Drive Trigger: Configure to monitor a specific folder for new videos
  2. OpenAI Transcriptie: Set up to extract audio and convert to text
  3. OpenAI Beschrijving Generator: Use a custom prompt to create engaging descriptions based on transcription
  4. Upload-Post HTTP-verzoek: Configure as described in previous steps with multi-platform selection
  5. Foutafhandeling: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Voorbeeldworkflow: Afbeeldingen-carrousel uitgever voor Instagram & TikTok

This workflow is available as a template: Bekijk op n8n.io or see all our n8n templates

What It Does

  • Automatiseert het uploaden van meerdere afbeeldingen als carrousels naar Instagram
  • Automatiseert het uploaden van meerdere afbeeldingen als diavoorstellingen naar TikTok
  • Stroomlijnt visueel contentbeheer over platforms
  • Behandelt meerdere afbeeldingsuploads met één trigger

Workflow Steps

  1. Trigger: Start the workflow with your selected images (e.g., from a schedule, webhook, or manual execution).
  2. Afbeeldingsverwerking: The workflow prepares images for platform-specific formats (consider nodes for resizing or formatting if needed).
  3. Upload-Post HTTP-verzoek: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Gebruik het `image[]` veld in plaats van `video`.
    • Stuur binaire gegevens voor elke afbeelding naar het `image[]` veld.
    • Stel `platform[]` in op `instagram` en/of `tiktok`.
  4. Platformoptimalisatie: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Add nodes to notify upon success or failure.

Refer to the n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

Hulp nodig?

Onze integratie-experts staan klaar om te helpen

Contact Support