Panduan Integrasi

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

Butuh bantuan membangun alur kerja Anda? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Hubungi kami

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.

Kelola Pengguna & Hubungkan Akun Sosial

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 Kelola Pengguna page in your Upload-Post dashboard.
  • Tambahkan pengguna baru atau pilih yang sudah ada.
  • Untuk pengguna yang dipilih, hubungkan semua akun media sosial (misalnya, TikTok, Instagram, Facebook) yang ingin Anda gunakan untuk menerbitkan konten melalui n8n.
  • Take note of the Pengidentifikasi Pengguna (this is typically the username or a unique ID associated with the user in Upload-Post). You will need this for your n8n workflows.

Penting: Akun media sosial harus terhubung ke *pengguna spesifik* yang ingin Anda gunakan dalam otomatisasi, bukan hanya secara umum ke akun Upload-Post Anda.

Hasilkan Kunci API

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

  • Go to the Kunci API page in your Upload-Post API keys section.
  • Hasilkan kunci API baru jika Anda belum memilikinya.
  • Salin kunci API ini dengan aman. Anda akan menggunakannya dalam pengaturan kredensial n8n Anda.

Catatan Keamanan: 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 Pengidentifikasi Pengguna and Kunci API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Ketersediaan Node:

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

Node Upload-Post disertakan secara default dalam versi terbaru n8n:

  1. Pastikan Anda telah menginstal versi terbaru dari n8n.
  2. Buka editor alur kerja n8n Anda.
  3. Cari "Upload Post" di perpustakaan node.
  4. Node harus tersedia tanpa instalasi tambahan.

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 Bagian API Unggah Pos (as described in the "Prerequisite" section above).

  1. In n8n, go to Kredensial > Baru.
  2. Search for API Unggah Pos dan pilih.
  3. Assign a memorable Nama Kredensial (e.g., "My Upload-Post API Key").
  4. Tempel Kunci API ke kolom yang ditentukan.
  5. Click Simpan.

Ini menyimpan kunci API Anda dengan aman untuk digunakan oleh node Upload-Post.

3. Utilize Node Operations in Your Alur Kerja

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

Unggah Foto

Unggah satu atau lebih foto. Menerima file atau URL.

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

Unggah Video

Unggah satu video. Menerima file atau URL.

Diperlukan: User Identifier, Platform(s), Video. Opsional: Title. Platform-specific fields available.

Unggah Teks

Unggah pos berbasis teks.

Diperlukan: 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 Dokumentasi API Unggah Pos 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.

Prasyarat: Pengguna Upload-Post & Kunci API

Pastikan Anda telah menyelesaikan langkah-langkah "Prasyarat: Pengaturan di Upload-Post" yang dijelaskan di awal panduan ini. Anda akan memerlukan:

Open Upload-Post App

Memahami Endpoint API Upload-Post & Membuat Permintaan

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Otorisasi 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

Endpoint 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 'Otorisasi: Apikey YOUR_API_KEY_HERE' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Judul Video Anda"' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -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

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 'Otorisasi: Apikey YOUR_API_KEY_HERE' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -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 (as the main content). caption can be used for internal tracking or specific platform needs.

curl \
  -H 'Otorisasi: Apikey YOUR_API_KEY_HERE' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -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

Catatan Penting untuk Konfigurasi Manual:

  • Replace YOUR_API_KEY_HERE with your actual API key from the Upload-Post Api section.
  • Replace YOUR_USER_IDENTIFIER dengan Pengidentifikasi Pengguna spesifik (misalnya, nama pengguna) dari Upload-Post yang memiliki akun media sosial target yang terhubung.
  • Sangat disarankan untuk menyimpan kunci API Anda di pengelola kredensial n8n dan merujuknya di node Permintaan HTTP Anda daripada mengkodekan secara langsung.
  • 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 }}).

Tip Pro: Uji & Hasilkan cURL dari Dasbor Upload-Post

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

Alur Kerja:

  1. Go to Dasbor Upload-Post
  2. Unggah konten Anda (video, foto, atau teks) ke platform yang Anda inginkan
  3. Setelah unggahan berhasil, salin perintah cURL yang dihasilkan
  4. Impor cURL ini langsung ke node Permintaan HTTP n8n Anda menggunakan fitur "Impor dari cURL"

Konfigurasi Node Permintaan HTTP n8n (Body)

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

Bidang Nilai / Deskripsi Diperlukan
user Your Pengidentifikasi Pengguna from Upload-Post (e.g., username). Diperlukan
platform[] Pengidentifikasi platform (misalnya, tiktok, instagram). Repeat for multiple platforms. Diperlukan
title Judul atau konten pos (bervariasi tergantung platform dan jenis pos). Opsional/Bervariasi
video Data file biner untuk unggahan video. Jika mengunggah video
image[] Data file biner untuk unggahan gambar. Ulangi untuk beberapa gambar dalam carousel/slideshow. Jika mengunggah gambar
n8n Configuration Tips:
  • Set HTTP Request node Metode to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Otorisasi header with your API key.
  • For Tipe Konten Badan, select multipart/form-data.
  • Tambahkan field ke body seperti 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 Dokumentasi API Unggah Pos.

Contoh: HTTP Node JSON (Video ke 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": "Otorisasi",
          "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 : 'Video hebat saya'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Unggah Video ke TikTok (Manual)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • Keamanan Kunci API: Always use n8n\'s credential management for your Upload-Post API Key. Avoid hardcoding it.
  • Pengidentifikasi Pengguna: Pastikan bidang user dalam body permintaan Anda mereferensikan dengan benar Pengidentifikasi Pengguna dari Upload-Post yang akun media sosialnya ingin Anda gunakan.
  • Saat membagikan alur kerja, ekspor tanpa data kredensial sensitif.

Contoh Alur Kerja: Penerbit Media Sosial Berbasis AI

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

What It Does

  • Memantau folder Google Drive untuk video baru
  • Mentraskripsikan video menggunakan OpenAI
  • Menghasilkan deskripsi media sosial yang menarik
  • Unggahan ke Instagram, TikTok & YouTube
  • Mengirim notifikasi saat selesai atau terjadi kesalahan

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

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

Contoh Alur Kerja: Penerbit Karusel Gambar untuk Instagram & TikTok

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

What It Does

  • Mengotomatiskan unggahan beberapa gambar sebagai carousel ke Instagram
  • Mengotomatiskan unggahan beberapa gambar sebagai tayangan slide ke TikTok
  • Mempermudah manajemen konten visual di berbagai platform
  • Menangani unggahan multi-gambar dengan satu pemicu

Workflow Steps

  1. Pemicu: Start the workflow with your selected images (e.g., from a schedule, webhook, or manual execution).
  2. Pemrosesan Gambar: The workflow prepares images for platform-specific formats (consider nodes for resizing or formatting if needed).
  3. Permintaan HTTP Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Gunakan field `image[]` sebagai pengganti `video`.
    • Kirim data biner untuk setiap gambar ke field `image[]`.
    • Atur `platform[]` ke `instagram` dan/atau `tiktok`.
  4. Optimisasi Platform: 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

Butuh Bantuan?

Para ahli integrasi kami siap membantu

Contact Support